# 1. Clone and setup
cd ~/data/workspace/projects/research-bridge
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

# 2. Start SearXNG
docker-compose -f config/searxng-docker-compose.yml up -d

# 3. Configure
export RESEARCH_BRIDGE_KIMI_API_KEY="sk-kimi-..."

# 4. Run
python -m src.main

Usage

curl -X POST http://localhost:8000/research \
  -H "Content-Type: application/json" \
  -d '{"query": "latest rust web frameworks", "depth": "shallow"}'

Documentation

Technical Design Document - Complete specification
AI Council Review - Architecture review

Project Structure

research-bridge/
├── src/
│   ├── api/           # FastAPI routes
│   ├── search/        # SearXNG client
│   ├── llm/           # Kimi for Coding synthesizer
│   ├── models/        # Pydantic models
│   └── middleware/    # Rate limiting, auth
├── tests/
│   ├── unit/          # Mocked, isolated
│   ├── integration/   # With real SearXNG
│   └── e2e/           # Full flow
├── config/            # Docker, settings
└── docs/              # Documentation

License

MIT