OneVoice

Platform-agnostic multi-agent system for automating digital presence management.

OneVoice provides a unified AI-powered interface for managing business presence across multiple platforms (Telegram, VK, Yandex.Business). It uses a hybrid integration model: API-based agents for platforms with public APIs, and RPA-based agents (Playwright) for platforms without.

Architecture

Frontend (Next.js :3000)
    │
    ├── REST /api/v1/*  ──►  API Service (:8080)
    │                         ├── PostgreSQL (users, businesses, integrations)
    │                         ├── MongoDB (conversations, messages)
    │                         └── Redis (sessions, rate limits)
    │
    └── SSE /chat/*  ──►  Orchestrator (:8090)
                           ├── LLM Router (OpenRouter / OpenAI / Anthropic / SelfHosted)
                           └── Tool dispatch via NATS
                                ├── Telegram Agent (Bot API)
                                ├── VK Agent (VK API)
                                ├── Yandex.Business Agent (Playwright RPA)
                                └── Google Business Agent (unverified — see services/agent-google-business/)

Tech Stack

• Backend: Go 1.24, Chi router, SQLC, pgx
• Frontend: Next.js 14, TypeScript, Tailwind CSS, shadcn/ui
• Messaging: NATS (request/reply for tool dispatch)
• Storage: PostgreSQL 16, MongoDB 7, Redis 7, MinIO (S3)
• LLM: Multi-provider router (OpenRouter, OpenAI, Anthropic, self-hosted)
• RPA: Playwright (for platforms without public APIs)
• Infra: Docker Compose, Prometheus + Grafana observability

Project Structure

pkg/                          # Shared Go packages (domain, auth, LLM router, A2A, health, metrics, tokenclient)
services/
  api/                        # REST API service (:8080)
  orchestrator/               # LLM agent loop, tool dispatch (:8090)
  frontend/                   # Next.js dashboard (:3000)
  agent-telegram/             # Telegram Bot API agent
  agent-vk/                   # VK API agent
  agent-yandex-business/      # Yandex.Business RPA agent (Playwright)
  agent-google-business/      # Google Business Profile agent (written, not yet verified)
migrations/                   # PostgreSQL + MongoDB migrations
test/integration/             # End-to-end integration tests
docs/                         # Architecture and coding guidelines

Quick Start

Prerequisites

• Docker and Docker Compose
• Go 1.24+
• Node.js 18+ and pnpm

Run with Docker Compose

# Copy and configure environment
cp .env.example .env

# Start all services
docker compose up -d

Services will be available at:

• Frontend: http://localhost:3000
• API: http://localhost:8080
• Orchestrator: http://localhost:8090

Local Development

# Install frontend dependencies
cd services/frontend && pnpm install && cd ../..

# Run Go services (requires infrastructure running via docker-compose)
go run ./services/api/cmd
go run ./services/orchestrator/cmd
go run ./services/agent-telegram/cmd
go run ./services/agent-vk/cmd
go run ./services/agent-yandex-business/cmd
# go run ./services/agent-google-business/cmd  # written, not yet verified

# Run frontend
cd services/frontend && pnpm dev

Development Commands

make lint-all        # Go + frontend linting
make test-all        # Go + frontend tests
make fmt-fix         # Auto-format everything

Documentation

• Architecture — system diagrams + module map
• Golden Principles — top-level rules enforced by linters
• Patterns / Anti-patterns: Go (patterns · anti) · Frontend (patterns · anti)
• Rules by topic: Go style · Frontend style · API design · Security & perf · Git workflow
• CODING_RULES.md — human-friendly index into the topic docs above

License

MIT - Daniil Mikhailov, 2026