egregore/reason
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
AI reasoning and LLM integration
3 commits 1 branch 0 tags 44 KiB
Find a file
egregore 28ec6e5611 Add README documentation 
Documents service purpose, endpoints, rate limiting, tool system, and configuration.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 19:57:16 +00:00
.gitignore Initial commit: Egregore brain service 2026-02-02 11:37:48 +00:00
__init__.py Initial commit: Egregore brain service 2026-02-02 11:37:48 +00:00
conversation.py Initial commit: Egregore brain service 2026-02-02 11:37:48 +00:00
main.py Add rate limiting to /process endpoint 2026-02-02 12:58:33 +00:00
prompts.py Initial commit: Egregore brain service 2026-02-02 11:37:48 +00:00
README.md Add README documentation 2026-02-02 19:57:16 +00:00
tools.py Initial commit: Egregore brain service 2026-02-02 11:37:48 +00:00

README.md

Reason Service

AI reasoning and LLM integration for Egregore.

Purpose

Processes conversations with Claude, handles tool execution, and manages the AI reasoning loop. This is where the "thinking" happens.

Endpoints

Endpoint Method Description
/process POST Process conversation with tool loop
/tool POST Execute a single tool directly
/tools GET List available tool definitions
/prompt GET Get current system prompt
/health GET Health check

Configuration

Environment variables (from ~/.env):

Variable Description Default
ANTHROPIC_API_KEY Claude API key Required
RATE_LIMIT Requests per minute 10/minute

Running

# Activate venv
source ~/.venv/bin/activate

# Run directly
python main.py

# Or via systemd
sudo systemctl start reason
sudo systemctl status reason

Rate Limiting

Built-in rate limiting (10 req/min per IP) protects against API abuse. Configure via RATE_LIMIT env var.

Tool System

The service supports a tool loop pattern:

  1. Receive conversation history
  2. Call Claude API
  3. If Claude requests tool use, execute tools
  4. Feed results back to Claude
  5. Repeat until Claude produces final response

Tools are defined in tools.py and include system operations available to the AI.

Dependencies

  • FastAPI
  • anthropic (Claude API client)
  • slowapi (rate limiting)