@auditbot/gateway

AI-powered audit report generation with specialized agents

The AuditBot Gateway provides the API server, CLI, and agent runtime for generating professional audit reports using AI agents.

Installation

# Global installation (for CLI)
npm install -g @auditbot/gateway

# Or as a project dependency
npm install @auditbot/gateway

Quick Start

# Run the setup wizard
auditbot setup

# Start the server
auditbot start

# Or start interactive chat
auditbot chat

Features

• 6 Specialized AI Agents - Data analysis, research, insights, writing, quality control, action planning
• Multi-LLM Support - Claude, OpenAI, Ollama (local)
• Multi-Channel - Discord, CLI, WebChat API
• Workflow Engine - Automated multi-step audit workflows
• Real-time Updates - WebSocket streaming

CLI Commands

# Setup wizard
auditbot setup

# Start the gateway server
auditbot start

# List agents
auditbot agents list

# Test an agent
auditbot agents test olivia

# Interactive chat
auditbot chat

# Show configuration
auditbot config show

Programmatic Usage

import { createServer } from '@auditbot/gateway'

const server = await createServer({
  port: 3000,
  llm: {
    defaultProvider: 'claude',
    providers: {
      claude: { apiKey: process.env.CLAUDE_API_KEY }
    }
  }
})

await server.start()

Configuration

Create ~/.auditbot/config.yaml:

server:
  port: 3000

llm:
  defaultProvider: claude
  providers:
    claude:
      model: claude-sonnet-4-20250514

search:
  provider: perplexity

channels:
  cli:
    enabled: true
  discord:
    enabled: false

Environment Variables

# LLM Providers
CLAUDE_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
OLLAMA_HOST=http://localhost:11434

# Search
PERPLEXITY_API_KEY=pplx-...

# Discord
DISCORD_BOT_TOKEN=...

The 6 Agents

| Agent | Role | |-------|------| | Olivia 📊 | Data Analyst - Excel/CSV analysis | | Victor 🔬 | Research Director - Research planning | | Helena 🔍 | Insight Hunter - Cross-source analysis | | Gabriel ✍️ | Report Writer - Professional prose | | Serge 🎯 | Quality Critic - Validation & scoring | | Nadia 📋 | Action Planner - Budget & roadmap |

API Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /api/health | Health check | | GET | /api/agents | List agents | | POST | /api/sessions | Create session | | POST | /api/chat | Send message | | POST | /api/workflows/:id/execute | Start workflow |

Documentation

Full documentation: https://github.com/your-org/auditbot

License

MIT