Deployment › Local Setup

Local Setup

Local mode runs all three services on your machine. No network auth required — loopback only. Ideal for personal use and development.

Prerequisites

Node.js >= 22.0.0
npm >= 10.0.0
ANTHROPIC_API_KEY (env var)

# Install Claude Code if not already present
npm install -g @anthropic-ai/claude-code

Installation

git clone https://github.com/jonathanARMS23/AI-Dev-Assistant.git
cd AI-Dev-Assistant

bash install.sh --with-server
# Does:
#   1. npm install            (ada-core)
#   2. npm install + tsc      (ada-api)
#   3. npm install + next build (ada-ui)
#   4. SQLite init + migrations
#   5. Generate .env.local for ada-ui
#   6. Symlink /usr/local/bin/ada → .claude/bin/ada.js

Start / Stop

ada server start            # start all 3 services
ada server start --verbose  # combined logs to stdout
ada server status           # show health of each service
ada server stop             # graceful shutdown
ada server restart ada-api  # restart a single service

Default Ports

ServiceEndpointEnv Var
ada-core IPC (local).claude/ada-core.sockADA_IPC_SOCKET
ada-core IPC (server)127.0.0.1:3099ADA_IPC_PORT
ada-api REST + WShttp://localhost:3001ADA_API_PORT
ada-uihttp://localhost:7777ADA_UI_PORT

Generated Files

~/.claude-<profile>/
├── ada-api.db          # SQLite (conversations, workspaces)
└── ada-api.db-wal      # WAL file (auto-created)

.env.local              # Next.js vars (NEXT_PUBLIC_API_URL, etc.)
.claude/
├── ada-core.sock       # Unix socket IPC (created on startup)
└── events.ndjson       # Append-only IPC journal