researcher

Autonomous looping AI research system for discovering and analyzing passive income strategies.

See ARCHITECTURE.md for system design.

Quick Start

# Install
pip install -e ".[dev]"

# Configure
cp config/default.yaml config/local.yaml
# Edit config/local.yaml with your preferences

# Set API keys
export RESEARCHER_LLM_API_KEY="your-key"
export RESEARCHER_SEARCH_API_KEY="your-key"

# Run
researcher run --config config/local.yaml

Project Structure

src/researcher/
├── core/          # Loop orchestration, planning, state management
├── discover/      # Web search, scraping, source plugins
├── analyze/       # Opportunity evaluation, scoring, deduplication
├── synthesize/    # Report generation, pattern detection
├── llm/           # LLM client abstraction, prompt management
├── storage/       # SQLite persistence, data models
├── config/        # Configuration loading and validation
└── prompts/       # Jinja2 prompt templates