@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

``bash


Global installation (for CLI)

npm install -g @auditbot/gateway

Or as a project dependency

npm install @auditbot/gateway
`

Quick Start

`bash


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

`bash


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

`typescript
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:

`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

`bash


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