A community-driven, multi-agent platform for financial applications — typed, async-first, and built for orchestration.

• Async, re-entrant orchestrator: streaming process_user_input can pause for human-in-the-loop (HITL) and resume safely.
• Planner with HITL: pauses on missing info/risky steps via async UserInputRequest, resumes after user feedback to produce an adequate plan.
• Streaming pipeline: Response → ResponseBuffer (buffered vs immediate with stable item_id) → ResponseRouter to UI and Store.
• Agent2Agent (A2A) integration: first-class support via a2a-sdk for agent-to-agent protocols, message schemas, and optional HTTP server interop.
• Conversation memory: in-memory/SQLite stores enable reproducible history, fast "resume from last", and auditability.
• Robustness & extensibility: typed events/errors, router side-effects (e.g., fail task), and clear seams to add agents, stores, transports, and planner logic.

See detailed flow diagrams and design notes in ../docs/CORE_ARCHITECTURE.md.

Set up the environment and verify your install:

uv sync --group dev
uv run python -c "import valuecell as vc; print(vc.__version__)"

Install the package in development mode with all dependencies (including testing tools like pytest, pytest-cov, and diff-cover):

uv sync --group dev

uv sync

⚠️ Caution: Isolate third‑party libraries in separate virtual environments (uv, venv, virtualenv, or conda) to prevent dependency conflicts between components.

# ai-hedge-fund
cd third_party/ai-hedge-fund
echo "uv: $(which uv)"
echo "python: $(which python)"

uv venv --python 3.12 && uv sync && uv pip list

• Python >= 3.12
• Dependencies managed via pyproject.toml