ajarbot/WINDOWS_QUICK_REFERENCE.md

Windows 11 Quick Reference

Quick command reference for testing and running Ajarbot on Windows 11.

First Time Setup (5 Minutes)

# Step 1: Navigate to project
cd c:\Users\fam1n\projects\ajarbot

# Step 2: Run automated setup
quick_start.bat

# Step 3: Set API key (if prompted)
# Get your key from: https://console.anthropic.com/

# Step 4: Verify installation
python test_installation.py

Test Examples (Choose One)

Option 1: Basic Agent Test

python example_usage.py

What it does: Tests basic chat and memory

Option 2: Pulse & Brain Monitoring

python example_bot_with_pulse_brain.py

What it does: Runs cost-effective monitoring To stop: Press Ctrl+C

Option 3: Task Scheduler

python example_bot_with_scheduler.py

What it does: Shows scheduled task execution To stop: Press Ctrl+C

Option 4: Multi-Platform Bot

# Generate config file
python bot_runner.py --init

# Edit config (add Slack/Telegram tokens)
notepad config\adapters.local.yaml

# Run bot
python bot_runner.py

To stop: Press Ctrl+C

Daily Commands

Activate Virtual Environment

cd c:\Users\fam1n\projects\ajarbot
.\venv\Scripts\activate

Start Bot

python bot_runner.py

Check Health

python bot_runner.py --health

View Logs

type logs\bot.log

Update Dependencies

pip install -r requirements.txt --upgrade

API Key Management

Set for Current Session

$env:ANTHROPIC_API_KEY = "sk-ant-your-key-here"

Set Permanently (System)

1. Press Win + X
2. Click "System"
3. Click "Advanced system settings"
4. Click "Environment Variables"
5. Under "User variables", click "New"
6. Variable: ANTHROPIC_API_KEY
7. Value: sk-ant-your-key-here

Check if Set

$env:ANTHROPIC_API_KEY

Running as Service

Quick Background Run

Start-Process python -ArgumentList "bot_runner.py" -WindowStyle Hidden

Stop Background Process

# Find process
Get-Process python | Where-Object {$_.CommandLine -like "*bot_runner*"}

# Stop it (replace <PID> with actual process ID)
Stop-Process -Id <PID>

Troubleshooting

"Python not recognized"

# Add to PATH
# Win + X -> System -> Advanced -> Environment Variables
# Edit PATH, add: C:\Users\fam1n\AppData\Local\Programs\Python\Python3XX

"Module not found"

.\venv\Scripts\activate
pip install -r requirements.txt --force-reinstall

"API key not found"

$env:ANTHROPIC_API_KEY = "sk-ant-your-key-here"

Reset Memory

Remove-Item -Recurse -Force memory_workspace
python example_usage.py

Project Files Quick Reference

File/Folder	Purpose
agent.py	Main agent logic
bot_runner.py	Multi-platform bot launcher
pulse_brain.py	Monitoring system
example_*.py	Example scripts to test
test_*.py	Test scripts
config/	Configuration files
docs/	Full documentation
adapters/	Platform integrations
memory_workspace/	Memory database

Model Switching

Tell your bot via chat:

• /haiku - Fast, cheap (default)
• /sonnet - Smart, caching enabled
• /status - Check current model

Need More Help?

• Complete Setup Guide: SETUP.md
• Full Windows Guide: docs/WINDOWS_DEPLOYMENT.md
• Main Documentation: docs/README.md