Skip to content

Getting Started

Jump to bottom
Michael Elliott edited this page Apr 4, 2026 · 3 revisions

Getting Started

Prerequisites

  • Node.js >= 20.0.0
  • npm >= 9
  • (Optional) Docker — for sandboxed code execution
  • (Optional) Ollama — for local LLM inference

Installation

One-Line Installer

curl -fsSL https://raw.githubusercontent.com/Djtony707/TITAN/main/install.sh | bash

npm (Global)

npm install -g titan-agent

From Source

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

Cloud Deploy

TITAN supports one-click deployment on:

  • Railway — railway up
  • Render — Use the render.yaml blueprint
  • Replit — Import from GitHub

First Run

Interactive Onboarding Wizard

titan onboard

The onboarding wizard walks you through:

  1. Choosing a provider (local Ollama or cloud API)
  2. Setting up API keys
  3. Selecting a default model
  4. Configuring your gateway password
  5. Enabling channels (optional)
  6. 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-..."
# or for local:
# export OLLAMA_BASE_URL="http://localhost:11434"

  3. Start the gateway:

    titan gateway

  4. Open Mission Control v2: 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

Checks Node.js version, provider connectivity, optional dependencies, channel status, and system resources.

Development Mode

npm run dev          # Run from source with hot reload
npm run dev:debug    # Debug mode with verbose logging
npm run test         # Run 4,655 tests across 154 files (vitest)
npm run typecheck    # TypeScript strict type check

Next Steps

  • Skills Reference — Browse all ~149 available tools
  • Channels — Connect Discord, Telegram, Slack, and 12 more channels
  • Dashboard — Explore Mission Control v2's 17 admin panels
  • CLI Commands — Full CLI reference
  • Security — Configure vault, sandbox, and shield

TITAN Wiki

Clone this wiki locally