Getting Started

Getting Started

Installation

npm install -g titan-agent

Or clone from source:

git clone https://github.com/Djtony707/TITAN.git
cd TITAN
npm install
npm run build

First Run

Interactive Onboarding

titan onboard

This walks you through:

1. Choosing a provider (local Ollama or cloud API)
2. Setting up API keys
3. Configuring your gateway password
4. Starting the gateway

Quick Start (Manual)

1. Create config directory:

   mkdir -p ~/.titan

2. Set up environment variables (or use ~/.titan/titan.json):

   export ANTHROPIC_API_KEY="sk-ant-..."
   # or
   export OPENAI_API_KEY="sk-..."

3. Start the gateway:

   titan gateway

4. Open Mission Control: Navigate to http://127.0.0.1:48420 in your browser.

Configuration

TITAN looks for configuration in ~/.titan/titan.json. A minimal config:

{
  "agent": {
    "model": "anthropic/claude-sonnet-4-20250514"
  },
  "gateway": {
    "port": 48420,
    "auth": {
      "mode": "password",
      "password": "your-password"
    }
  }
}

See Configuration for the full schema reference.

System Health Check

titan doctor

Development Mode

npm run dev          # Run from source
npm run dev:debug    # Debug mode with verbose logging
npm run test         # Run tests
npm run typecheck    # Type check