Welcome to the AI Impostor Game documentation. This directory contains comprehensive documentation for understanding, developing, and deploying the application.
Complete technical documentation covering:
- System architecture and component breakdown
- Game mechanics and AI agent behavior
- API specification and data models
- Development workflow and setup
- Future enhancements and security considerations
Comprehensive testing instructions including:
- Complete endpoint testing with curl, Postman, HTTPie
- Full game workflow testing scripts (Bash & Python)
- Error scenario testing and debugging tips
- Performance testing and monitoring
- Expected response examples and patterns
For immediate setup, see the backend README for installation and running instructions.
AI-powered social deduction game where autonomous agents play Among Us-style impostor elimination rounds with sophisticated reasoning and strategy.
- 8 AI Agents with distinct personalities (crewmates + 1 impostor)
- Natural Language Processing for agent communication
- Strategic Decision Making with private thoughts and public statements
- RESTful API for easy frontend integration
- Real-time Game State management
- Backend: FastAPI + Python
- AI Engine: Cerebras Cloud SDK (Qwen-3-235B)
- Data Validation: Pydantic
- Server: Uvicorn ASGI
- Read the Application Overview for technical details
- Follow the Backend Setup Guide for installation
- Explore the API endpoints via
/docswhen server is running
This documentation is designed to help developers understand and extend the AI Impostor Game system. For questions or improvements, please refer to the detailed architecture documentation.