docs/DEPENDENCIES.md

Dependency Map

This document groups the INFJ Bot's dependencies by purpose and identifies candidates for slimming.

Core Runtime (Required)

Package	Purpose	Slimmable?
chromadb	Vector database for semantic memory	No
sentence-transformers	Local embeddings (MiniLM)	No
torch	Required by sentence-transformers	No
numpy	Numerical ops	No
python-dotenv	.env file loading	No
PyYAML	Config / prompt YAML parsing	No
pydantic	Data validation (FastAPI, MCP)	No

LLM Providers (Pick One+)

Package	Provider	Slimmable?
google-genai	Gemini (new SDK)	Keep both or pick one
google-generativeai	Gemini (legacy SDK)	Keep both or pick one
google-auth-*	Google auth flows	If using Gemini
ollama	Local LLM fallback	If using local models

Slim option: If you only use Gemini, drop ollama and Anthropic packages. If you only use local models, drop all Google packages.

Web & API

Package	Purpose	Slimmable?
fastapi	Web UI + REST API	No (unless headless)
uvicorn	ASGI server	No (unless headless)
sse-starlette	SSE streaming for Observatory	No (unless headless)
starlette	FastAPI dependency	Transitive
httpx	HTTP client	No
websockets	WebSocket support	If not using WS chat

Slim option: Run in CLI-only mode (cli.py) and drop FastAPI/uvicorn/sse-starlette.

Voice & Audio

Package	Purpose	Slimmable?
faster-whisper	Speech-to-text	Yes — drop if no voice
piper-tts	Text-to-speech	Yes — drop if no voice
sounddevice	Audio I/O	Yes — drop if no voice
soundfile	Audio file handling	Yes — drop if no voice

Slim option: Remove all four if you never use voice commands.

Tools & Integrations

Package	Purpose	Slimmable?
playwright	Browser automation	Yes — drop if no web tools
duckduckgo-search	Web search	Yes — drop if no search
PyPDF2	PDF parsing	Yes — drop if no PDF tools
mcp	Model Context Protocol	Yes — drop if no MCP servers
markdown	Markdown rendering	Transitive

Data Science (Optional)

Package	Purpose	Slimmable?
pandas	Data analysis	Yes — only used in some tools
matplotlib	Plotting	Yes — only used in some tools

Dev / Quality (Not in requirements.txt)

Package	Purpose	Install
pytest	Testing	pip install pytest
ruff	Linting + formatting	pip install ruff
mypy	Type checking	pip install mypy
bandit	Security scanning	pip install bandit
detect-secrets	Secret detection	pip install detect-secrets

Slimming Guide

To create a minimal install for headless, text-only operation:

# Core only
pip install chromadb sentence-transformers torch numpy python-dotenv PyYAML pydantic httpx

# Pick your LLM backend
pip install google-genai google-generativeai google-auth-oauthlib
# OR
pip install ollama

# Optional: web UI
pip install fastapi uvicorn sse-starlette

This drops ~500MB+ of voice, browser, and data science dependencies.