JustDoBot logoJustDoBot
Open SourceMITLocal-firstNo hosted bot data

Your AI Workhorse.
Secure by design. Your data, your control.

Works with your Claude Subscription — no additional API fees. Real-time streaming responses.

curl -fsSL https://justdobot.com/install.sh | bash

Requires Node.js 20+ • macOS/Linux/Windows

No per-request API billing in Claude Subscription mode. External providers are used only for enabled integrations.

View on GitHub

Terminal Preview

Why JustDoBot

Built for developers, power users and privacy advocates.

No API Usage Fees

Unlike per-call API products, JustDoBot can run via your Claude subscription workflow. In this mode, you avoid per-request API billing.

Your Data Stays Yours

Built on SQLite. Runs locally or in Docker. Your data stays under your control. Secrets are configured via .env, with auditable logs for all key operations.

Remembers Everything

Stores your preferences, key facts and goals with deadlines. Uses hybrid search — full-text plus vector — to retrieve the right context from local SQLite.

Obsidian Vault Integration

Connect your Obsidian vault. JustDoBot indexes your notes incrementally, searches them from Telegram and uses them as context for answers.

Proactive Intelligence

Checks your Gmail, Google Calendar and active goals, then messages you first when something needs attention. Can even call your phone for urgent matters.

Safe Code Execution

Ask it to build a game or a script. It spins up an isolated Docker container, writes code, tests it and delivers the result.

See It in Action

Interactive examples of real Telegram workflows.

User: What is my schedule today and are there any urgent emails?

Bot: You have 3 meetings. One urgent email from Server Alerts. Shall I summarize it?

Engineered for Performance.

Built with Bun, Grammy and SQLite. A modular plugin architecture designed for stability.

Telegram
JustDoBot Core
Plugin Registry
Local SQLite
Docker Sandbox
⚡ Bun Runtime🐘 SQLite Vector Search🐳 Isolated Docker🤖 Claude Agent SDK📧 Gmail & Calendar📓 Obsidian Vault📞 Twilio Calls🎙️ Voice (STT/TTS)

Localized for 15 Languages.

JustDoBot adapts to your language. Bot responses and setup wizard UI switch instantly.

🇸🇦 العربية🇨🇳 中文🇺🇸 English🇫🇷 Français🇩🇪 Deutsch🇮🇳 हिन्दी🇮🇹 Italiano🇯🇵 日本語🇰🇷 한국어🇵🇱 Polski🇵🇹 Português🇷🇺 Русский🇪🇸 Español🇹🇷 Türkçe🇺🇦 Українська

Voice call language availability may vary by provider configuration.

Before You Install

Does no API usage fees mean fully free?

The no per-request API billing claim applies to Claude Subscription mode. Some optional third-party integrations may have their own pricing.

Where is my data stored?

Your bot data is stored locally in SQLite or inside your own Docker environment. No hosted bot storage is provided by the project.

Can I disable proactive behavior?

Yes. You can configure quiet hours, cooldowns and disable proactive flows if you prefer manual-only operation.

How does Obsidian integration work?

Point JustDoBot at your vault folder. It indexes Markdown files incrementally, builds vector embeddings and makes them searchable from Telegram. Your notes never leave your machine.

Is voice and phone support included?

Voice messages work out of the box with Gemini or ElevenLabs. Phone calls require a Twilio account. Full two-way phone conversations are planned for an upcoming release.