How akshayasurala/multi-agent-negotiation-simulator works
This is a real-estate negotiation platform for AI-vs-AI simulation and human practice. Users choose a property scenario and agent personalities, then negotiate through offers and decisions; the platform tracks rounds and outcomes and can produce transcripts and reports. The frontend calls a FastAPI backend, whose router coordinates negotiation flows, agents, session state, and reporting. The README documents capabilities beyond the sampled excerpts; edges to those capabilities are included only where documented, and unsampled implementation details are not inferred.
Main entry points: negotiation_router.py Negotiation API · practice_agent.py Practice Agent · main.jsx Negotiation UI · main.py FastAPI Application
Components 21
User Experience
- Negotiation UI
src/main.jsx - API Client
frontend/services/negotiation-api.js - Negotiation Metrics
frontend/components/negotiation-metrics.js
Negotiation Backend
- FastAPI Application
backend/main.py - Negotiation API
backend/routers/negotiation_router.py - Practice Sessions
backend/agents/practice_store.py - AI Negotiation Runner
backend/negotiation_runner.py - API Data Models
backend/models.py
Negotiation Agents
- Turn Orchestrator
backend/agents/orchestrator_agent.py - Counteroffer Evaluator
backend/agents/counteroffer_evaluator.py - Deadlock Detector
backend/agents/deadlock_detector.py - Practice Agent
backend/agents/practice_agent.py - Reasoning Engine
backend/agents/reasoning_engine.py
Property and Reports
- Scenario Definitions
backend/scenarios.py - Agent Personalities
backend/personalities.py - Property Dataset
- Property Selection
backend/dataset_manager.py - Property Utilities
backend/property_utils.py - Reports and Transcripts
backend/report_generator.py
Other components
- User
- Gemini LLM
Connections 24
- User → Negotiation UI: selects and negotiates
- Negotiation UI → API Client: requests actions
src/main.jsx - API Client → Negotiation API: calls API
- Negotiation API → FastAPI Application: routes through
backend/main.py - FastAPI Application → Property Selection: loads dataset
backend/main.py - FastAPI Application → Negotiation API: sets dataset
backend/main.py - Negotiation API → Scenario Definitions: serves scenarios
- Negotiation API → Agent Personalities: serves personalities
- Property Selection → Property Dataset: reads properties
- Negotiation API → AI Negotiation Runner: runs simulation
backend/routers/negotiation_router.py - Negotiation API → Turn Orchestrator: coordinates turns
backend/routers/negotiation_router.py - AI Negotiation Runner → Practice Agent: uses agent logic
backend/negotiation_runner.py - Negotiation API → Practice Agent: handles practice
backend/routers/negotiation_router.py - Negotiation API → Counteroffer Evaluator: evaluates offers
backend/routers/negotiation_router.py - Negotiation API → Deadlock Detector: checks deadlocks
- Negotiation API → Practice Sessions: stores session state
backend/routers/negotiation_router.py - Practice Agent → Practice Sessions: uses session model
backend/agents/practice_agent.py - Negotiation API → Reasoning Engine: requests reasoning
backend/routers/negotiation_router.py - Reasoning Engine → Practice Agent: uses price formatting
backend/agents/reasoning_engine.py - Reasoning Engine → Gemini LLM: generates responses
backend/agents/reasoning_engine.py - Negotiation API → Reports and Transcripts: generates reports
backend/routers/negotiation_router.py - Negotiation API → Property Utilities: uses property helpers
backend/routers/negotiation_router.py - Negotiation API → API Data Models: validates API data
backend/routers/negotiation_router.py - Negotiation UI → Negotiation Metrics: renders metrics
src/main.jsx