Documentation

Technical guide for the Forge Lab Brain ecosystem. Orchestrate AI agents, manage deployments, and understand our token-based economy.

Getting Started

Forge Lab Brain is a hybrid AI development platform that merges Large Language Models (LLMs) with a live, in-browser Node.js environment (WebContainers). Unlike standard chatbots, Forge Lab can execute code, install npm packages, and deploy full-stack applications instantly.

Technical Requirement: Forge Lab uses SharedArrayBuffer for its in-browser terminal. This requires a modern browser (Chrome, Edge, Firefox) supporting Cross-Origin-Embedder-Policy headers.

Instant Environment

No localhost setup. The terminal runs entirely within your browser tab via WebAssembly.

Multi-Agent Architecture

Complex tasks are broken down and distributed to specialized agents (Coding, Debugging, Planning).

How Brain Mode Works

Brain Mode is the orchestration layer of Forge Lab. When you submit a request, it is not sent directly to a coding model. Instead, it passes through our cognitive pipeline:

// 1. User Input "Create a React dashboard with Supabase auth" // 2. Conductor Agent (Meta-Llama / Gemini Flash) analyzeRequest() -> "Complex Task detected" createPlan() -> ["Scaffold Vite", "Install Dependencies", "Setup Auth"] // 3. Execution (Senior Dev Agent) await executeStep("Scaffold Vite") // 4. Auto-Fix (Bug Hunter Agent) if (terminal.error) { fixError(terminal.logs) }

Agent Roles

Depending on your subscription tier, different models power these agents.

🚦 Conductor

Role: Project Manager

Decides how to solve the problem. It does not write code but directs other agents.

💻 Senior Dev

Role: Implementation

Writes high-quality, typed code. Expert in React, Node.js, and PHP.

🐛 Bug Hunter

Role: QA & Fixer

Automatically reads terminal output. If a build fails, it intervenes without user prompt.

Brain Knowledge

Brain Knowledge is our persistent memory system (RAG - Retrieval Augmented Generation). It allows the agents to "remember" your project context, preferences, and documentation across different sessions.

Privacy & Security: Knowledge data is stored in a vector database linked strictly to your User ID. We do not train our public models on your private code snippets.

What it remembers:

  • Tech Stack: "User prefers Tailwind over CSS modules."
  • Project Structure: Where you keep your components vs. pages.
  • API Keys: (Stored encrypted) To facilitate auto-connection to 3rd party services.

Billing & Tokens

Forge Lab uses a flexible hybrid billing system designed for developers. We utilize Stripe for secure payment processing.

1. FLT (Forge Lab Tokens)

To handle micro-transactions for various AI models (GPT-5.2, Claude 4.5, etc.), we convert currency into FLT.

1 USD = 1,000,000 FLT (Forge Lab Tokens)

This allows for granular billing. For example, a simple chat message might cost 500 FLT, while a complex image generation might cost 40,000 FLT.

2. Refund Policy

  • Subscriptions (BYOK): Refundable within the first 7 days if the service has not been utilized significantly.
  • Token Packs: Unused token packs are refundable within 14 days. Partially used packs are non-refundable.

BYOK (Bring Your Own Key)

For power users who already have an account with OpenRouter, we offer the BYOK model.

Direct Connection

You input your OpenRouter API Key. Usage is billed directly to your OpenRouter account.

Platform Fee

Forge Lab charges a small monthly subscription ($7.99/mo) to access the UI and Orchestration tools (Conductor).

Security: Your API keys are encrypted at rest using AES-256 and are never exposed to the frontend client.