ernestmoyo/7square-lab

Africa-focused conversational AI app development platform # 7Square Lab Africa-focused conversational AI platform for building web applications through natural language. **Describe your app. We'll build it.** ## Architecture ``` ┌─────────────────┐ SSE ┌──────────────────┐ │ Next.js 14+ │◄────────────►│ Python FastAPI │ │ (Frontend) │ REST API │ (AI Backend) │ │ Port 3000 │──────────────►│ Port 8000 │ └────────┬────────┘ └────────┬───────────┘ │ │ │ Auth + DB │ Auth verify + DB │ │ Claude API ▼ ▼ ┌─────────────────┐ ┌──────────────────┐ │ Supabase │ │ Anthropic API │ │ (Auth + DB) │ │ (Claude) │ └─────────────────┘ └──────────────────┘ ``` ## Tech Stack - **Frontend**: Next.js 14 (App Router), TailwindCSS, shadcn/ui - **Backend**: Python FastAPI, SSE streaming - **Database**: Supabase (PostgreSQL + Auth) - **AI**: Claude API (Anthropic) for requirement gathering + code generation ## Quick Start ### Prerequisites - Node.js 20+ - Python 3.11+ - Supabase project (supabase.com) - Anthropic API key (console.anthropic.com) ### 1. Clone and configure ```bash git clone github.com cd 7square-lab # Copy environment files cp .env.example .env cp frontend/.env.local.example frontend/.env.local cp backend/.env.example backend/.env # Fill in your keys in each .env file ``` ### 2. Set up the database Run `supabase/migrations/001_initial_schema.sql` in your Supabase SQL Editor. ### 3. Run with Docker ```bash docker-compose up ``` Or run each service manually: ### 3a. Frontend (without Docker) ```bash cd frontend npm install npm run dev ``` ### 3b. Backend (without Docker) ```bash cd backend python -m venv .venv source .venv/bin/activate # or .venv\Scripts\activate on Windows pip install -r requirements.txt uvicorn app.main:app --reload ``` …