README.md

---
title: Perplexity AI Clone
emoji: 🔍
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: mit
---

# Perplexity AI Clone

An AI-powered search and research assistant with multiple modes:

- **Automatic**: Auto-routes to best mode based on query
- **Web Search**: Real-time web search with citations
- **RAG**: Search uploaded documents
- **Deep Research**: Multi-step research with synthesis
- **Agentic**: Multi-agent RAG with planning
- **Analysis**: Data analysis and insights
- **Summarize**: Summarize content and documents
- **Product MVP**: Generate MVP blueprints from ideas
- **Video Brain**: Analyze YouTube videos

## Features

- 🔍 Real-time web search with Tavily (with AI answers)
- 📚 Document upload and RAG
- 🤖 LangGraph-powered pipelines
- 💡 Follow-up question suggestions
- 🖼️ Image search integration
- 📊 Knowledge panels
- 🎥 YouTube video analysis

## Environment Variables (Required!)

⚠️ **IMPORTANT**: Set these secrets in your Hugging Face Space settings:

1. Go to your Space Settings → Variables and secrets
2. Add these as **Secrets** (not Repository secrets):

- `GROQ_API_KEY`: Your Groq API key (get from https://console.groq.com)
- `TAVILY_API_KEY`: Your Tavily API key (get from https://tavily.com)

Without these keys, web search and LLM responses will not work!

## Tech Stack

- FastAPI backend
- Streamlit frontend
- LangChain + LangGraph
- Groq LLM (compound-beta)
- FAISS vector store
- Sentence Transformers embeddings