Voysse

Open-source, white-label platform for agencies to build, run and manage AI agents for their clients.

Documentation · Quick start · Self-hosting · Discussions

---

What is Voysse?

Voysse is a multi-tenant workspace where an agency creates AI agents for its clients, gives each client a branded portal, and talks to end users over WhatsApp or an embeddable web chat widget.

Bring your own OpenAI / Anthropic keys and self-host the whole stack with one command.

The product is now named Voysse. Repository URLs and technical identifiers still use openvoiss during the staged, compatibility-safe rename; see Brand migration.

Quick start

git clone https://github.com/kanazawa-dev/voysse.git
cd voysse
make setup
make up

Then open http://localhost and create your first agency.

See the getting started guide for the full walkthrough.

Features

Agents

• Instructions, personality, per-client and per-agent context, timezone, plus temperature / max-tokens / memory controls
• Multimodal: image recognition (vision) and audio transcription for incoming media
• Creation wizard with live token counter and industry starter templates
• Learn more

Knowledge base

• Manual context, structured Q&A pairs and PDF upload
• Embedding-based semantic retrieval with keyword fallback
• Portable JSON embeddings — no database extension required
• Learn more

AI providers

• Bring-your-own OpenAI (Responses API) and Anthropic (Messages API) keys — agency-level, encrypted and validated when saved
• Any model id your key can serve, including custom or fine-tuned ones (the API host itself is fixed per provider)
• Learn more

Custom tools

• Per-agent HTTP tools: any REST endpoint with path / query / body parameters, encrypted auth headers and SSRF guard
• MCP servers (Streamable HTTP or SSE) with test-before-save connection checks and cached tool discovery
• Tool usage recorded per reply and surfaced in the playground, including failure details
• Learn more

Channels

• WhatsApp Cloud API (official Meta API) — bring your own Meta app credentials, signed webhooks, per-client number
• WhatsApp QR through Baileys — QR link, per-client number, encrypted persistent session
• Embeddable web chat widget for any website
• Instagram DM and Facebook Messenger (planned)
• Learn more

Operations

• Unified Inbox with server-side search, filter tabs, unread tracking, pagination and human takeover
• Per-client portal with its own login and Inbox, optionally under the client's own custom domain (DNS-verified, automatic HTTPS)
• Dashboard with activity, top agents, token usage by model and date-range filter
• Agency white-label (name, identifier, color, logo)
• Learn more

Architecture

Three services plus PostgreSQL, orchestrated by Docker Compose.

All data lives in PostgreSQL; provider keys and WhatsApp sessions are encrypted at rest. Every query is scoped by agency_id for tenant isolation, and public endpoints are rate-limited per client IP. A Caddy gateway serves the app and API from a single origin (/api/* → backend).

Read the architecture guide

Project structure

apps/
  api/         FastAPI backend (app/, migrations/, tests/)
  web/         Next.js frontend (app/, components/, lib/, types/)
  whatsapp/    Baileys WhatsApp bridge (src/)
docs/          Self-hosting and operations guide
scripts/       Helper scripts (generate-docker-env.sh)
Makefile       Common commands (make help)
docker-compose.yml

Documentation

Full documentation is available at docs.voysse.cl.

License

Copyright © 2026 Voysse.

Voysse is licensed under the Functional Source License, Version 1.1, MIT Future License (FSL-1.1-MIT). See the license file for the full terms.

Community

• Discussions for questions and ideas
• Issues for bug reports and feature requests