MichaelMatsobe/Potso-AI

South African Generative AI # Potso AI - Full-Stack Multi-Agent Intelligence System A production-ready full-stack application featuring a South African multi-agent AI system powered by Google Gemini, with web, mobile (iOS & Android), and backend deployments. ## 🚀 Features - **Multi-Agent Reasoning**: Collaborative AI agents (Modisa, Tshepo, Kgakgamatso, Tlhaloganyo) - **Real-Time Chat Interface**: React 19 web app with Vite - **Mobile Support**: React Native + Expo for iOS & Android - **Firebase Backend**: Firestore database + Authentication - **REST API**: Express.js backend with modular architecture - **Docker Ready**: Containerized deployment on Cloud Run, AWS, or any cloud provider ## 📋 Project Structure ``` potso-ai/ ├── src/ # Web frontend (React + Vite) │ ├── components/ # React components │ ├── services/ # API client services │ └── types.ts # TypeScript types ├── backend/ # Express.js backend │ ├── routes/ # API endpoints (auth, chat) │ ├── services/ # Business logic (Gemini) │ ├── middleware/ # Auth middleware │ └── config/ # Firebase config ├── mobile/ # React Native + Expo │ ├── app/ # Expo Router pages │ ├── components/ # Mobile UI components │ └── services/ # Mobile API services ├── server.ts # Express server entry point ├── Dockerfile # Docker configuration ├── docker-compose.yml # Docker Compose setup └── DEPLOYMENT.md # Detailed deployment guide ``` ## 🛠️ Tech Stack ### Frontend Web - React 19 - Vite - TypeScript - Tailwind CSS - Lucide React (Icons) - Three.js (3D visualization) ### Mobile - React Native - Expo - Expo Router - Firebase SDK ### Backend - Node.js - Express.js - TypeScript - Firebase Admin SDK - Google Gemini API ### Infrastructure - Docker - Firebase/Firestore - Cloud Run / AWS / Vercel ## 📱 Getting Started ### Quick Start (Developme …