Ctrlk
Sign inVisit bito.aiVideo Library
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Standalone deployment

Run AI Architect privately on your own workstation. Setup takes about 5 to 10 minutes.

Your AI coding agent connects automatically during installation.

Sharing with a team or installing on a server? Use the Enterprise deployment guide instead.

Before you begin

Have the following ready. See Prerequisites & requirements for creation links and details.

Requirement
Notes

Bito API key

alpha.bito.ai/home/advanced

Git provider token (PAT)

GitHub, GitLab, Bitbucket, or Azure DevOps

Your email (optional)

Associates the automatic coding-agent registration with you

Docker Desktop 20.10+

With Compose v2

Free ports

5001-5006 on localhost

1

Pre-seed your configuration (optional)

To install without prompts, provide your configuration before running the installer. Skip this step to install interactively, and the installer asks for each value instead.

mkdir -p ~/.bitoarch
cat > ~/.bitoarch/install.yaml <<'EOF'
bito_api_key: "<your-bito-api-key>"
git:
  provider: github
  access_token: "<your-git-pat>"
user_email: "you@company.com"    # associates coding-agent registration with you
EOF

Start from the full template, install.default.yaml, to pre-seed any option: LLM provider keys, Insights, custom ports, and more.

2

Install and index

curl -fsSL https://aiarchitect.bito.ai/standalone/install.sh | bash

If you pre-seeded your configuration, the installer runs without prompts. Otherwise, it asks for your Bito API key and Git provider token.

The installer validates prerequisites, deploys the services, then fetches your repository list from your Git provider and asks how to proceed:

  • Auto (recommended): saves the fetched repository list and starts indexing automatically (about 3-10 minutes per repository).

  • Manual: follow the steps shown in the terminal to complete configuration. In summary:

    1. bitoarch config edit repos (review or trim the list, as each indexed repository consumes LLM tokens)

    2. bitoarch add-repos (apply the list)

    3. bitoarch index-repos (start indexing)

On success, the installer prints your MCP URL and access token.

Your AI coding agent connects automatically. Standalone serves MCP over HTTPS at https://localhost:5001/mcp with a locally trusted certificate, and the installer registers this endpoint in every detected AI coding agent (Claude Code, Cursor, Windsurf, VS Code, Junie, and JetBrains AI Assistant). During installation you are asked for an email to associate with this registration (or pre-seed user_email); press Enter to skip it. Restart each tool when prompted. No further setup is needed.

bitoarch mcp-info    # view the MCP URL, token, and authentication mode anytime

Installed a new IDE after setup? Register it with bitoarch mcp-install. Re-running the install command is also safe: existing configuration is reused with no prompts.

Manual agent configuration (if an IDE is not auto-detected)
{
  "mcpServers": {
    "BitoAIArchitect": {
      "url": "https://localhost:5001/mcp",
      "headers": {
        "Authorization": "Bearer <TOKEN>",
        "x-email-id": "you@company.com"
      }
    }
  }
}

Run bitoarch mcp-info for your URL and token. The x-email-id header is the email associated with your registration. For per-tool guidance, see:

3

Verify the installation

bitoarch status        # all services healthy
bitoarch index-status  # reaches "completed"
bitoarch mcp-test      # end-to-end MCP check passes

Setup is complete. Ask your AI coding agent a cross-repository question to confirm it is using AI Architect context.

Next steps

Optional: connect the AI Code Review Agent for codebase-aware reviews, or enable Insights.

The MCP certificate renews automatically every day through your OS scheduler. Check it anytime with bitoarch mcp-cert status.

Last updated