viora

AI staff that listen, talk and finish the work, in English and Swahili. By INCPRITECH.

• Voice desk (viora desktop): a Jarvis-style voice assistant on your computer that thinks with the AI you already use (Claude Code, opencode, Codex, Gemini CLI, Cursor, Qwen Code, Goose, Aider, Amp, Crush, any command, or an API/Ollama model).
• Tasks (viora task): hand it a job; your agent works in the background and viora tells you aloud when it's done.
• MCP server (viora mcp): gives any MCP app a voice, ears, viora answers and background tasks.
• Website and app assistant: answers customers only from a business's own information, with WhatsApp handoff.

Natural female and male voices in English and Swahili, and Swahili detection that handles mixed sentences.

On your computer

uv tool install "viora-ai[desktop]"     # or: pipx install "viora-ai[desktop]"
viora setup                             # AI, ears, voice and wake word
viora desktop                           # talk ("viora, …"), or type
viora task "tidy the screenshots on my desktop"
claude mcp add viora -- viora mcp       # or any MCP app: viora mcp --help

Extras: desktop (microphone/speaker and MP3 decoding on every OS), local (offline speech to text with faster-whisper), anthropic, pdf.

pip install viora-ai

The package is viora-ai on PyPI; in Python you import viora, and the command is viora.

Just want the viora command? uv tool install viora-ai (or pipx install viora-ai). On Arch, Ubuntu 24.04+ and Debian 12+, a plain pip install outside a virtual environment is blocked by the system; use one of these or a venv.

Self-host

viora init --example     # writes viora.yaml (a sample school profile)
viora ingest             # reads the profile and website, builds the knowledge base
viora ask "Do you offer school transport?"
viora serve              # HTTP API, widget.js, sdk.js and live voice on :8000

Then add the widget to any page:

<script src="https://your-server/widget.js" data-site="kilele-academy" async></script>

Configure providers in .env: Cloudflare Workers AI (default), OpenAI-compatible APIs, Ollama, Anthropic Claude, or offline (VIORA_EMBEDDINGS=hash, VIORA_CHAT=extractive).

Use viora from Python software

from viora.client import Client

bot = Client("https://viora-cloud.depriver-tech.workers.dev", "your-site")
for text in bot.stream("Ada ya bweni ni shilingi ngapi?"):
    print(text, end="", flush=True)

Real-time voice: viora.live.LiveSession, or viora talk --site your-site for a hands-free assistant in the terminal (pip install "viora-ai[audio]" on Windows and macOS).

Documentation: https://viora.depriver-tech.workers.dev/docs/

MIT licence.