60 lines
1.6 KiB
Markdown
60 lines
1.6 KiB
Markdown
|
# Ajarbot Setup Guide
|
||
|
|
|
||
|
|
## Quick Start
|
||
|
|
|
||
|
|
1. **Clone the repository**
|
||
|
|
```bash
|
||
|
|
git clone https://vulcan.apophisnetworking.net/jramos/ajarbot.git
|
||
|
|
cd ajarbot
|
||
|
|
```
|
||
|
|
|
||
|
|
2. **Set up Python environment**
|
||
|
|
```bash
|
||
|
|
python -m venv venv
|
||
|
|
venv\Scripts\activate # Windows
|
||
|
|
pip install -r requirements.txt
|
||
|
|
```
|
||
|
|
|
||
|
|
3. **Configure credentials**
|
||
|
|
```bash
|
||
|
|
# Copy example files
|
||
|
|
copy .env.example .env
|
||
|
|
copy config\scheduled_tasks.example.yaml config\scheduled_tasks.yaml
|
||
|
|
copy config\adapters.yaml config\adapters.local.yaml
|
||
|
|
```
|
||
|
|
|
||
|
|
4. **Add your API keys**
|
||
|
|
- Edit `.env` and add your `ANTHROPIC_API_KEY`
|
||
|
|
- Edit `config\adapters.local.yaml` with your Slack/Telegram tokens
|
||
|
|
- Edit `config\scheduled_tasks.yaml` with your user/channel IDs
|
||
|
|
|
||
|
|
5. **Run the bot**
|
||
|
|
```bash
|
||
|
|
python bot_runner.py
|
||
|
|
```
|
||
|
|
|
||
|
|
## Important Files (NOT in Git)
|
||
|
|
|
||
|
|
These files contain your secrets and are ignored by git:
|
||
|
|
- `.env` - Your API keys
|
||
|
|
- `config/adapters.local.yaml` - Your bot tokens
|
||
|
|
- `config/scheduled_tasks.yaml` - Your user IDs
|
||
|
|
- `memory_workspace/memory_index.db` - Your conversation history
|
||
|
|
- `memory_workspace/memory/*.md` - Your daily logs
|
||
|
|
|
||
|
|
## Model Switching Commands
|
||
|
|
|
||
|
|
Send these commands to your bot:
|
||
|
|
- `/haiku` - Switch to Haiku (cheap, fast)
|
||
|
|
- `/sonnet` - Switch to Sonnet (smart, caching enabled)
|
||
|
|
- `/status` - Check current model and settings
|
||
|
|
|
||
|
|
## Cost Optimization
|
||
|
|
|
||
|
|
- Default model: Haiku 4.5 (12x cheaper than Sonnet)
|
||
|
|
- Prompt caching: Automatic when using Sonnet (90% savings)
|
||
|
|
- Context optimized: 3 messages, 2 memory results
|
||
|
|
- Max tool iterations: 5
|
||
|
|
|
||
|
|
See [README.md](README.md) for full documentation.
|