Repolode
Submit
sirquy

sirquy/bestie

Self-hosted, local-first AI companion runtime with a Vietnamese-first character, local SQLite memory, Telegram/Zalo channels, skills, and permission-gated tools.

View on GitHubWebsite
Stars
106
Forks
1
Open issues
18
Last commit
2 days ago

What is it?

Bestie is a TypeScript CLI and runtime for running a personalized AI companion on your own machine. Its character and prompt files are editable, and it defaults to Vietnamese. Conversations and memory are stored locally in SQLite, with pending approvals and governance controls for what gets remembered.

The project connects to multiple LLM providers, including OpenAI-compatible endpoints, Anthropic, Gemini, Groq, OpenRouter, Ollama, and local Gemini, Claude, and Codex CLI logins. It supports model fallbacks and provider diagnostics. A localhost Web UI, started with `bestie ui`, covers chat, memory, a knowledge graph, channels, approvals, MCP, tools, skills, and settings.

Channels include Telegram and Zalo polling, plus cron schedules, all managed as daemons or user services on Linux, macOS, and Windows. Tools that touch local files or external actions go through a permission gate, and external content is treated as untrusted. The project is not a replacement for professional mental health, legal, medical, or financial advice.

Key features

  • 01Vietnamese-first character with editable character and prompt files
  • 02Local SQLite memory with approval and governance controls
  • 03Telegram and Zalo channel runtimes plus cron schedules
  • 04Multiple LLM providers with model fallbacks and diagnostics
  • 05Permission-gated local tools and MCP calls
  • 06Localhost Web UI started with `bestie ui`

Use cases

  • Running a private personal AI assistant that stays on your own machine
  • Chatting with an AI companion through Telegram or Zalo
  • Routing a personal assistant through a local Ollama or CLI-based model login
  • Experimenting with a permission-gated agent runtime that controls local file access

Topics

#ai-agent#local-first#self-hosted#telegram-bot#typescript#personal-assistant#mcp#vietnamese-ai#agent-runtime#ai-companion

FAQ

What is bestie?
Self-hosted, local-first AI companion runtime with a Vietnamese-first character, local SQLite memory, Telegram/Zalo channels, skills, and permission-gated tools. Bestie is a TypeScript CLI and runtime for running a personalized AI companion on your own machine. Its character and prompt files are editable, and it defaults to Vietnamese. Conversations and memory are stored locally in SQLite, with pending approvals and governance controls for what gets remembered.
Is bestie free to use? What license does it have?
bestie is open source under the MIT license. Check the license terms before using it in commercial products.
Is bestie still maintained?
Actively maintained. The last commit to bestie was on Oct 20, 2026.
What can I use bestie for?
Running a private personal AI assistant that stays on your own machine Chatting with an AI companion through Telegram or Zalo Routing a personal assistant through a local Ollama or CLI-based model login Experimenting with a permission-gated agent runtime that controls local file access
Where can I get bestie?
The source code and installation instructions are on GitHub: https://github.com/sirquy/bestie

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects