Skip to content

manifest-startup/manifest-api

v1.0.0

Guidance for agents using Manifest's public REST API to manage startup ideas and generate business documents.

Why Manifest

Most ideas die between the note and the first real step. Founders juggle a canvas in one tool, research in another, a pitch deck in a third, and legal and HR templates somewhere else. Nothing stays in sync, and money often goes on incorporation before anyone has checked whether the idea holds up.

Manifest is an IDE for startups. You capture the idea once. AI turns it into linked, structured work (canvas, research, documents and a pitch) that updates when the idea changes. Teammates and investors can join the same workspace, and you decide what gets published.

Capture the spark. Develop the case. Operate with confidence.

What is in the workspace

FeatureWhere
Idea workspace: capture ideas, iterate on each aspect, invite teammates/ideas
AI artifacts: Business Model Canvas, pitch decks and patent, HR and legal-oriented drafts, with optional web research/ideas/:id/:aspect
Similar ideas: related concepts and references surfaced earlyIdea workspace
Pitch Reels: a short-form feed of pitch clips for published ideas, with optional AI video when configured/pitch-reels
Messages: direct conversations; messaging about an idea requires it to be published/messages
Follow and invest flows for full accounts; guests are kept out of sensitive actionsGraphQL
Manifest Voice: hands-free navigation and commands when signed inEverywhere
One sign-in with Open Media: "Continue with Open Media" (passkey, email link or password, optional two-step verification, all managed in Open Media); existing accounts link by verified email/login
Guest sessions: explore the workspace without an account, then continue with Open Media to keep itLanding page, /login
MCP server: connect Claude and other AI clients to a Manifest backendmcp_server/

On iPhone, an iOS-style layout is chosen automatically (or with ?view=ios), mirroring the same routes.

Quick start

You need: Python 3.11+, Node.js and npm. No database is required to try it: without Supabase credentials the backend runs in a demo mode with in-memory storage.

git clone https://github.com/Manifest-Startup/Manifest.git
cd Manifest
python3 -m pip install -e .   # installs the manifest-dev CLI
manifest-dev setup            # backend and frontend dependencies
manifest-dev start            # backend :8000, frontend :3000

Open http://localhost:3000. The backend is at http://localhost:8000 and GraphQL at http://localhost:8000/graphql. In demo mode, Continue with Open Media signs you in as the bundled demo user without contacting Open Media (docs/QUICKSTART.md); set DEMO_MODE=1 to force it. You can also open the repo in VS Code or Cursor and choose Reopen in Container.

Environment variables

Create a .env file in the project root (see .env.example). Common entries:

SUPABASE_URL=your_supabase_url
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key
OPENAI_API_KEY=your_openai_api_key            # optional local-dev fallback; users normally add their own key in Account settings
AI_MODEL=gpt-4o-mini
VOICE_AGENT_MODEL=gpt-4o-mini
VOICE_AGENT_TTS_MODEL=tts-1
VOICE_AGENT_TTS_VOICE=nova
VOICE_REALTIME_ENABLED=false                          # near-instant speech-to-speech (WebRTC); costs more than tts-1
VOICE_REALTIME_MODEL=gpt-4o-realtime-preview          # realtime voices differ from TTS (no `nova`)
VOICE_REALTIME_VOICE=shimmer
VOICE_REALTIME_ALLOW_GUESTS=false                     # guests are blocked from realtime by default (cost)
MANIFEST_AGENT_LOOP_SECRET=shared_internal_secret     # optional; internal agent-loop routes
MANIFEST_GITHUB_REPO=Manifest-Startup/Manifest        # optional; internal feedback issue sync
MANIFEST_GITHUB_TOKEN=your_github_token               # optional
POSTHOG_API_KEY=your_posthog_api_key                  # optional; analytics
SESSION_SECRET=replace_this_with_a_long_random_secret_for_non_demo_auth
GOOGLE_API_KEY=                                       # optional; Pitch Reel video (Gemini)

Frontend analytics keys (when used): REACT_APP_PUBLIC_POSTHOG_KEY, REACT_APP_PUBLIC_POSTHOG_HOST. GraphQL URL override: REACT_APP_GRAPHQL_URL (default /graphql).

Surveys (/research for visitors, /feedback/survey when signed in) store responses in Postgres (survey_responses); apply the migrations in supabase/migrations/. See docs/customer-research-surveys.md.

Connect an AI client with the MCP server

The MCP package lives in mcp_server/. It is not published on PyPI yet, so install it from this repository and point it at a running backend (the default is http://localhost:8000):

python3 -m pip install ./mcp_server
export MANIFEST_API_URL="http://localhost:8000"
export MANIFEST_API_TOKEN="your-api-token"
manifest-mcp

Client configuration examples are in mcp_server/README.md.

Command line

manifest does everything you can do in the app from a terminal: every GraphQL query and mutation is a command, generated from the schema, plus API keys, privacy and data requests.

pip install -e mcp_server        # installs `manifest` (and the MCP server)
manifest login                   # approve this computer in the browser (Open Media sign-in)
manifest ideas
manifest create-idea --title "Lawn robots"
manifest commands --search idea  # list every command

Sessions last 30 days and show up under Account → Security, where you can revoke them. See docs/CLI.md.

How it works

React + Vite SPA (desktop and iOS layouts)
        │  Apollo GraphQL · Socket.IO
        ▼
FastAPI + Strawberry GraphQL ──► ManifestManager orchestrator ──► OpenAI (artifacts, research, voice)
        │                                                     └─► Google GenAI (optional Pitch Reel video)
        ▼
Supabase / PostgreSQL  (or in-memory demo mode)
LayerTechnologies
FrontendReact 18, TypeScript, Vite, Tailwind CSS, Apollo Client, Redux Toolkit, Socket.IO client
BackendPython 3.11+, FastAPI, Strawberry GraphQL, Socket.IO
DataSupabase / PostgreSQL, with an in-memory demo mode
AIOpenAI API with bring-your-own-key (each user adds their own key); optional Google GenAI for reel video
AnalyticsPostHog (optional)

Repository layout and app routes

├── backend/           # FastAPI + Strawberry GraphQL API
│   └── app/
│       ├── routes/ graphql/ middleware/   # API layer: HTTP in, call a service
│       ├── services/<domain>/             # business logic: ai, canvas, documents, ideas,
│       │                                  #   pitch_reels, social, voice, identity, compliance, …
│       ├── auth/ security/                # sign-in, sessions, cookies, permissions
│       ├── db/                            # Postgres / Supabase access
│       └── utils/ prompts/ assets/        # logger, prompt files, bundled assets
├── frontend/          # React + Vite app, one folder per feature in src/features/
├── deploy/cloudflare/ # Edge Worker: serves the app, proxies the API
├── mcp_server/        # Installable MCP server for AI tools
├── ios/               # Native SwiftUI prototype
├── supabase/          # Database migrations
├── scripts/           # check.py (local checks), codegraph/ (code map), setup helpers
├── tests/             # tooling, load and production smoke tests
├── src/manifest_dev/  # manifest-dev CLI (pip install -e .)
└── docs/              # Guides, API, security and legal templates
AreaPathNotes
Landing/Marketing and demo entry
About/learn-moreHow Manifest works
Ideas/ideas, /ideas/:id/:aspectSigned-in workspace
Pitch Reels/pitch-reelsImmersive feed (/shorts and /discover redirect here)
Messages/messagesInbox and threads
Account/account, /account/billingProfile, settings and billing (/portfolio redirects here)
Sign in/login (/auth, /signup and the old password-reset links redirect here)Continue with Open Media, or try without an account
Surveys/research, /feedback/surveyVisitor and signed-in feedback
Docs/docs, /docs/guide, /docs/apiIn-app documentation
Legal/legal/terms, /legal/privacyTerms and privacy

Architecture notes: docs/ARCHITECTURE_REFERENCE.md and AGENTS.md. Leaving Replit: docs/MIGRATION_FROM_REPLIT.md and docs/LOCAL_DEV_WITHOUT_REPLIT.md.

Internal quality loops

Operations automation, not end-user features:

Honest status

Manifest is in development. The public site at manifeststartup.com is labelled a demo and says plainly that it is not operational and should not be used for real business decisions.

  • AI-generated canvases, research and documents are drafts. Legal, patent and HR outputs are not legal advice and need professional review.
  • Pitch Reel video generation only runs when a Google GenAI key is configured.
  • Follow, invest and funding flows are product features in the app, not a regulated investment platform. Billing and equity mechanics must match live billing code before they are offered.
  • The MCP package is installed from this repository; it is not on PyPI yet.
  • AI features run on each user's own OpenAI API key (Account → AI settings). Manifest does not pay for or proxy anyone's AI usage.
  • Manifest is open source under the MIT license. This public repository started from a cleaned snapshot on 2026-11-14; earlier private history (which held customer data and company records) is not published.

Documentation

DocumentWhat it covers
Docs hubEvery maintained guide
Quick startLocal setup in detail
APIThe backend API
CLIThe manifest command line
Voice agent APIManifest Voice
Product visionWhat Manifest is for and how it is built
Founding memoEdited founding notes

Contributing

Contributions are welcome. Start with CONTRIBUTING.md: it covers setup, the one local check command (python3 scripts/check.py) and how pull requests are reviewed. Everyone taking part follows the Code of Conduct. Report security problems privately as described in SECURITY.md, never in a public issue.

License

MIT © Manifest Startup