Skip to main content
Vibra Code is fully open source under AGPL-3.0, which means you can run every part of it on your own infrastructure. Self-hosting gives you direct access to the AI prompts, lets you swap AI providers, and removes any usage limits imposed by a hosted service.

What self-hosting gives you

CapabilityDetails
Full infrastructure controlRun the backend, database, and job server wherever you want
Custom AI promptsEdit lib/prompts.ts to change how the AI agent builds apps
Swap AI providersSwitch between Claude, Cursor, and Gemini with one env var
No usage limitsYour API keys, your quotas
Fork and modifyChange anything — UI, agent behavior, billing, templates

What you need

Before you begin, you’ll need accounts and API keys from these services:
ServicePurposeRequired
AnthropicClaude AI code generationYes (default agent)
E2BCloud sandboxes for code executionYes
ClerkAuthentication (shared by backend and mobile)Yes
ConvexReal-time databaseYes
StripeWeb payment processingOptional
RevenueCatMobile in-app purchasesOptional
AssemblyAIVoice-to-text transcriptionOptional

Architecture overview

When a user describes an app, this is what happens end-to-end:
  Phone                     Server                        Cloud
┌──────────┐   API    ┌──────────────┐   Queue    ┌──────────────┐
│  Expo    │ ──────── │   Next.js    │ ────────── │  E2B Sandbox │
│  iOS App │          │   + Convex   │   Inngest  │  + AI Agent  │
└────┬─────┘          └──────┬───────┘            └──────┬───────┘
     │                       │                           │
     └───── real-time sync ──┴─── code generation ───────┘
  1. User describes an app on their phone
  2. Backend creates a session in Convex
  3. Inngest spawns an E2B sandbox
  4. AI agent generates code inside the sandbox
  5. Updates stream via Convex back to the phone
  6. Phone shows a live preview via the sandbox tunnel URL
The three components you need to deploy are:
  • Backend — the Next.js API server, Convex database, and Inngest job server
  • E2B sandbox template — the Docker image that runs inside each cloud sandbox
  • Mobile app — the modified Expo Go app that connects to your backend
Vibra Code is licensed under AGPL-3.0. If you distribute a modified version — including as a hosted service — you must release your modifications under the same license.

Setup guides

Deploy the backend

Set up Next.js, Convex, and Inngest on your own server.

Build the mobile app

Build the iOS and Android app from source using Xcode and Metro.

Build the E2B sandbox

Create and deploy a custom E2B sandbox template for code execution.

Environment variables

Complete reference for all backend and mobile environment variables.

Build docs developers (and LLMs) love