tangison/tangison-agent

Tangison Agent — Sovereign AI agent runtime. Self-hosted, multi-channel, voice-enabled. Built for Africa, architectured by Tangi Iigonda. # Tangison Agent > An AI workforce that runs inside your infrastructure. Sovereign AI agent runtime. Self-hosted, multi-channel, voice-enabled. Built for Africa, architectured by Tangi Iigonda in Windhoek, Namibia. ## Install ```bash npm install -g tangison-agent ``` ## Quick Start ```bash # 1. Set your model key export OPENROUTER_API_KEY=sk-or-v1-your-key-here # 2. Start the agent tangison start # 3. Open the Web Control UI open localhost ``` ## Configuration Create a `.env` file or set environment variables: ```env # Model (required) OPENROUTER_API_KEY=sk-or-v1-your-key-here TANGISON_MODEL_PROVIDER=openrouter TANGISON_MODEL=openrouter/auto # Channels (optional) TELEGRAM_BOT_TOKEN=your-telegram-token DISCORD_BOT_TOKEN=your-discord-token WHATSAPP_ENABLED=true # Voice (optional) TANGISON_VOICE_ENABLED=true TANGISON_STT_ENGINE=whisper TANGISON_TTS_ENGINE=edge-tts TANGISON_TTS_VOICE=en-NA-GovernorNeumann # Defaults (Namibian context built in) TANGISON_TIMEZONE=Africa/Windhoek TANGISON_CURRENCY=NAD TANGISON_LANGUAGE=en-NA ``` ## Architecture ``` ┌──────────────────────────────────────────────────────┐ │ TANGISON AGENT │ ├──────────────────────────────────────────────────────┤ │ Channels: │ │ ├── Telegram (grammY) │ │ ├── WhatsApp (Baileys) │ │ ├── Discord (discord.js) │ │ └── WebChat (WebSocket) │ │ │ │ Core: │ │ ├── Agent (Plan-Execute-Deliver loop) │ │ ├── Skill Registry (9 built-in + custom) │ │ ├── Channel Gateway (multi-channel routing) │ │ ├── Event Bus (typed pub/sub) │ │ └── Audit Log (SQLite, enterprise-grade) │ │ │ │ Memory …