Quick Start

After logging in to Mosayic, the initial page focuses on connecting the local API to your browser.

Download and Set Up the API

1. Click the Download button to get a zip file containing the entire API
2. Unzip the file and place it in your preferred directory
3. Rename the folder to something meaningful (e.g., myproject-api)

A typical project structure might look like this:

• Directoryprojects/

  • Directorymy-app/

    • Directorymyproject-api/ Python API codebase

      • …
    • Directorymyproject-mobile/ React Native mobile app

      • …

More Than Just a Mosayic Bridge

The Python API isn’t just for running Mosayic commands – it’s designed to be your production backend. If you inspect pyproject.toml, you’ll notice that mosaygent is listed as a dev dependency. This means it won’t be included when you deploy to production.

You can use this API for all your backend logic:

• AI agents and LLM integrations
• Push notification delivery
• Payment processing (Stripe, etc.)
• Any server-side business logic

This approach keeps everything in one place, eliminating the need to scatter functionality across Firebase Cloud Functions or Supabase Edge Functions.

Tip

Secret API keys can be safely injected via settings.py using Pydantic’s settings management.

Never expose secrets in code

Secret keys must only be stored in:

• .env.local (stays on your machine)
• Google Cloud Secret Manager (for production)

Do not place secrets in:

• Your mobile application codebase
• Your API codebase directly
• .env.prod.yaml (this is for non-secret environment variables only)

More on secrets management later in the documentation.

Run the Local Server

1. Open the API folder in VS Code, Cursor, or your preferred IDE
2. If using VS Code, press F5 or click the play button in the debugger (a .vscode folder is pre-configured)
3. Return to Mosayic in your browser – it should now show as initialized

From this point, Mosayic will guide you through the remaining setup steps.