Ecosystem¶

SimpleContext is the core engine of a four-repository ecosystem. Each repo has a specific role and they're designed to work together.

The Repositories¶

SimpleContext              ← 🧠 Core engine (this)
       │
       ├── SimpleContext-Agents   ← 🤖 Agent YAML definitions
       ├── SimpleContext-Plugin   ← 🔌 Plugin registry
       └── SimpleContext-Bot      ← 🚀 Telegram bot interface

How They Connect¶

SimpleContext → Agents¶

Agents are YAML files loaded by the AgentRegistry. SimpleContext-Bot auto-downloads them from SimpleContext-Agents during setup:

simplecontext-bot setup
# Step 2/6: Downloads all agents from SimpleContext-Agents

You can also install agents manually:

git clone https://github.com/zacxyonly/SimpleContext-Agents
cp SimpleContext-Agents/agents/*.yaml your-project/agents/

SimpleContext → Plugins¶

Plugins extend the core via hooks. SimpleContext-Bot auto-discovers any .py file in the plugins/ folder:

# Install via bot CLI
simplecontext-bot plugins install vector-search

# Or manually drop the file
cp vector_search_plugin.py ~/.simplecontext-bot/plugins/
simplecontext-bot start   # auto-detected on startup

SimpleContext-Bot as the Interface¶

SimpleContext-Bot wraps all of the above into a turnkey Telegram bot:

pip install simplecontext-bot
simplecontext-bot setup   # downloads engine + agents + optional plugins
simplecontext-bot start   # runs the bot

Minimum Setup¶

If you just want to run the core engine in your own application:

SimpleContext (core) + your own agents/ folder

sc = SimpleContext("config.yaml")
# Done. No other repos needed.

Full Ecosystem Setup¶

SimpleContext (core)
+ SimpleContext-Agents (15 agents)
+ SimpleContext-Plugin (vector search + community plugins)
+ SimpleContext-Bot (Telegram interface)

pip install simplecontext-bot
simplecontext-bot setup
simplecontext-bot start

Version Compatibility¶