Skip to content

Installation

SimpleContext requires Python 3.10+ and has zero external dependencies in its core.

The simplest way. No pip, no install.

git clone https://github.com/zacxyonly/SimpleContext.git
cp -r SimpleContext/simplecontext your-project/

That's it. Import directly:

from simplecontext import SimpleContext

Option B — pip install

pip install simplecontext-ai

Package name vs import name

The PyPI package is named simplecontext-ai (name simplecontext was already taken). The import stays the same: 

from simplecontext import SimpleContext

Option C — SimpleContext-Bot (batteries included)

If you want a ready-to-run Telegram bot with everything pre-configured:

pip install simplecontext-bot
simplecontext-bot setup   # interactive wizard — does everything
simplecontext-bot start

The wizard automatically downloads the engine, agents, and optional plugins. See the Bot Setup guide for details.

Optional Dependencies

The core has zero dependencies. Install extras only if needed:

pip install redis>=5.0

pip install psycopg2-binary>=2.9

pip install litellm

Verify Installation

from simplecontext import SimpleContext

sc = SimpleContext()
print(sc)
# <SimpleContext v4 backend='memory' agents=0 users=0 plugins=0>

Project Structure After Setup

your-project/
├── simplecontext/     ← core engine (copied or installed)
├── agents/            ← agent YAML files
│   ├── general.yaml
│   ├── coding.yaml
│   └── ...
├── plugins/           ← optional plugins
├── config.yaml        ← your configuration
└── main.py

Next Steps