A powerful, full-stack AI chat application that can browse the web to provide up-to-date answers. Built with modern tools for speed and reliability.
🎓 New to this project? Check out the MASTERY_GUIDE.md for a complete beginner-friendly explanation of how this system works!
- AI-Powered Chat: Uses OpenAI GPT-4o for intelligent responses.
- Web Browing: Automatically searches the internet when you ask about current events (powered by Tavily).
- Source Citations: Tells you exactly where it found the information.
- Data Persistence: Saves all your conversations securely in a Supabase database.
- Modern Architecture: Built with a clean separation of Frontend and Backend.
- Frontend: Next.js (React) - Modern, high-performance UI
- Backend: FastAPI (Python) - High-performance async API
- Database: Supabase (PostgreSQL) - Real-time data storage
- AI: OpenAI GPT-4o & Tavily Search
- Python 3.11+
- Node.js (Required for Frontend)
- A
.envfile with your API keys (OpenAI, Supabase, Tavily).
We have a unified script to start everything for you:
Windows (PowerShell):
.\run_app.ps1This script will:
- Check for the backend.
- Start the FastAPI server on
http://localhost:8000. - Start the Next.js frontend on
http://localhost:3000.
If you see "Table not found" errors, you need to run the initial migration in your Supabase SQL Editor.
See supabase/migrations/001_initial_schema.sql.
Web-Intellect-Agent/
├── backend/ # The Brain (FastAPI Server)
│ ├── app/
│ │ ├── services/ # AI and Search Logic
│ │ ├── api/ # API Endpoints
│ │ └── db/ # Database Queries
├── frontend/ # The Face (Next.js Frontend)
├── streamlit_app/ # (Legacy) Streamlit Frontend
├── supabase/ # Database Migrations
└── run_app.ps1 # Startup Script
- Mastery Guide - Start Here! Detailed explanation for learners.
- Project Status - Current development status.
- Setup Guide - Detailed setup instructions.
Feel free to open issues or submit pull requests. This project uses .gitignore to keep secrets safe—ensure you never commit your .env file!