Skip to content

Bot Setup

SimpleContext-Bot is a ready-to-run Telegram bot powered by SimpleContext. A built-in wizard handles all setup automatically.

Requirements

  • Python 3.10+
  • Telegram Bot Token (from @BotFather)
  • LLM API key (Gemini free / OpenAI / Ollama local)

Install

git clone https://github.com/zacxyonly/SimpleContext-Bot.git
cd SimpleContext-Bot
pip install .

Run Setup Wizard

simplecontext-bot setup

The wizard walks through 6 steps:

═══════════════════════════════════════════════════════
  🧠 SimpleContext-Bot — Setup Wizard
═══════════════════════════════════════════════════════

Step 1/6: Download SimpleContext Engine
  ⬇️  Downloading SimpleContext engine...  ✅
  📦 Installing engine...                  ✅

Step 2/6: Download Agent Definitions
  ⬇️  Downloading SimpleContext-Agents...  ✅
  📦 Installing agents... (15 agents)      ✅

Step 3/6: Plugin Ecosystem (Optional)
  Install Vector Search?
  → Semantic similarity search — find memory by meaning, not exact words
  [y/N]: y
  ⬇️  Downloading plugin registry...       ✅
  📦 Installing Vector Search...           ✅

Step 4/6: Telegram Bot Token
  Get token from @BotFather on Telegram.
  Telegram Bot Token: ****

Step 5/6: LLM Provider
  1. Gemini (Google) ⭐ FREE
  2. OpenAI
  3. Ollama (Local, Free)
  Enter choice [1]: 1
  Gemini API Key: ****

Step 6/6: Final Configuration
  Default agent [general]: general
  ✅ Setup Complete!

Get Your Tokens

  1. Open Telegram → search @BotFather
  2. Send /newbot
  3. Follow the steps → copy the token
  1. Go to aistudio.google.com/app/apikey
  2. Click Create API Key → copy
  1. Go to platform.openai.com/api-keys
  2. Click Create new secret key → copy
  1. Install from ollama.ai
  2. ollama pull llama3
  3. Make sure Ollama is running before starting the bot

Start the Bot

simplecontext-bot start

🚀 Bot is running — 15 plugins agents, 1 plugins, 1 plugin commands
   Plugin commands: /semantic

CLI Reference

simplecontext-bot setup                  # First-time setup
simplecontext-bot start                  # Start the bot
simplecontext-bot start --debug          # Start with verbose logging
simplecontext-bot status                 # Show configuration summary
simplecontext-bot status --test          # Test LLM connection
simplecontext-bot agents                 # List installed agents
simplecontext-bot update                 # Update engine + agents
simplecontext-bot update --engine-only   # Update engine only
simplecontext-bot update --agents-only   # Update agents only
simplecontext-bot plugins list           # List all plugins
simplecontext-bot plugins install <id>   # Install a plugin
simplecontext-bot plugins remove <id>    # Remove a plugin

Files After Setup

Everything is stored in ~/.simplecontext-bot/:

~/.simplecontext-bot/
├── config.json        ← your settings (tokens, LLM config, plugin list)
├── bot.db             ← conversation memory (SQLite)
├── simplecontext/     ← engine (auto-downloaded)
├── agents/            ← agent YAML files (auto-downloaded)
│   ├── general.yaml
│   ├── coding.yaml
│   └── ...
└── plugins/           ← installed plugins
    └── vector_search_plugin.py

Start Fresh

If something goes wrong, wipe everything and start over:

rm -rf ~/.simplecontext-bot
simplecontext-bot setup