An assistant has personality, tools, memory, and a transport. You define one in YAML, run it, and use it on Discord or Slack. Same binary, different YAMLs: a coding assistant, a support bot, a Discord bot. Vikusha ships with a default assistant ready to use.
Vikusha is the harness your assistants run on. It handles the agent loop, context engineering, prompt caching, memory, tool execution, and transport wiring. You write the character YAML, the harness does the rest.
- Providers: Anthropic, OpenAI-compatible, Ollama.
- Tools: bash, file, web search, grep, glob.
- Memory: file, SQLite, pgvector.
- Transports: terminal, Discord, Slack, Telegram.
- Isolation: separate workspace and secrets per assistant.
- Scaffolder:
vikusha create namespawns a new assistant. - Observability: structured logs, tokens, cost, duration.
go install github.com/snowztech/vikusha/cmd/vikusha@latest
vikusha setup
vikusha run- ARCHITECTURE.md: core concepts, interfaces, directory layout.
- CHARACTER.md: full YAML spec with examples.
- ROADMAP.md: where we're headed.
MIT. Copyright (c) 2026 snowztech.