{"id":26353316,"url":"https://github.com/sanatren/azazel","last_synced_at":"2026-04-11T21:45:59.504Z","repository":{"id":281360856,"uuid":"945044057","full_name":"sanatren/Azazel","owner":"sanatren","description":"Supercharge Legacy models with RAG, image analysis (GPT-4o vision), code execution, and web search. Transform it into a lean, multimodal powerhouse—smarter, faster, and more versatile, without the heavyweight cost. ","archived":false,"fork":false,"pushed_at":"2025-03-15T14:12:22.000Z","size":2599,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-15T14:26:02.915Z","etag":null,"topics":["faiss","huggingface-transformers","langchain-python","openai","openai-vision","rag-memory","supabase","whisper"],"latest_commit_sha":null,"homepage":"https://azazel.streamlit.app/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sanatren.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-08T14:29:40.000Z","updated_at":"2025-03-15T14:12:25.000Z","dependencies_parsed_at":"2025-03-15T14:36:29.486Z","dependency_job_id":null,"html_url":"https://github.com/sanatren/Azazel","commit_stats":null,"previous_names":["sanatren/gpt_prob","sanatren/turbofusion","sanatren/azazel"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanatren%2FAzazel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanatren%2FAzazel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanatren%2FAzazel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanatren%2FAzazel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sanatren","download_url":"https://codeload.github.com/sanatren/Azazel/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243858059,"owners_count":20359269,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["faiss","huggingface-transformers","langchain-python","openai","openai-vision","rag-memory","supabase","whisper"],"created_at":"2025-03-16T11:17:47.391Z","updated_at":"2026-04-11T21:45:59.495Z","avatar_url":"https://github.com/sanatren.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 [Azazel AI](https://brave-comfort-production-f62d.up.railway.app/) - Advanced AI Assistant\n\nModern, full-featured AI assistant with beautiful ChatGPT-like interface, document processing, web search, and code execution.\n\n[Use azazel from here](https://brave-comfort-production-f62d.up.railway.app/)\n\n![License](https://img.shields.io/badge/license-MIT-blue.svg)\n![Python](https://img.shields.io/badge/python-3.12-blue.svg)\n![FastAPI](https://img.shields.io/badge/FastAPI-0.109-green.svg)\n\n## ✨ Features\n\n### 🎯 Core Capabilities\n- **💬 Intelligent Chat** - Natural conversations powered by OpenAI GPT-4\n- **🌐 Web Search** - Real-time information from Google with intelligent query optimization\n- **📄 Document Processing** - Upload and query PDFs, DOCX, Excel, PowerPoint\n- **🖼️ Vision Analysis** - Analyze and discuss images using GPT-4o-mini vision\n- **💻 Code Execution** - Safe Python code generation and execution\n- **🎭 Personality Modes** - Customizable AI personalities and tones\n- **🌍 Multi-language** - Support for multiple languages\n- **🎤 Speech Integration** - Voice input using OpenAI Whisper\n\n### 🚀 Technical Features\n- **Real-time Streaming** - See responses as they're generated\n- **RAG (Retrieval-Augmented Generation)** - Context-aware responses from your documents\n- **Session Management** - Persistent chat history with Supabase\n- **Sentiment Analysis** - Emotion detection and adaptive responses\n- **Model Switching** - GPT-4, GPT-4 Turbo, or GPT-4o-mini based on your needs\n- **Modern UI** - Beautiful ChatGPT-like interface with Tailwind CSS\n- **Mobile Responsive** - Works perfectly on all devices\n\n## 🏗️ Architecture\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                Frontend (HTML/CSS/JS)                    │\n│  • Modern ChatGPT-like UI                               │\n│  • Tailwind CSS styling                                 │\n│  • Real-time streaming                                  │\n└────────────────────┬────────────────────────────────────┘\n                     │ HTTP/SSE\n┌────────────────────┴────────────────────────────────────┐\n│                  Backend (FastAPI)                       │\n│  • RESTful APIs                                         │\n│  • Streaming responses                                  │\n│  • Document processing                                  │\n│  • Web search integration                               │\n└────────────────────┬────────────────────────────────────┘\n                     │\n        ┌────────────┴────────────┐\n        │                         │\n┌───────┴────────┐      ┌────────┴────────┐\n│   OpenAI API   │      │  Google Search   │\n│   • GPT-4      │      │  • Custom CSE    │\n│   • Vision     │      │  • Wikipedia     │\n│   • Whisper    │      │                  │\n└────────────────┘      └──────────────────┘\n```\n\n## 🚀 Quick Start\n\n### Option 1: Docker (Recommended)\n\n```bash\n# Clone the repository\ngit clone \u003cyour-repo-url\u003e\ncd Azazel\n\n# Create environment file\ncat \u003e .env \u003c\u003c EOF\nGOOGLE_API_KEY=your_google_api_key\nGOOGLE_CSE_ID=your_google_cse_id\nSUPABASE_URL=your_supabase_url\nSUPABASE_KEY=your_supabase_key\nEOF\n\n# Start with Docker Compose\ndocker-compose up -d\n\n# Access the app\n# Frontend: http://localhost:8080\n# API Docs: http://localhost:8000/docs\n```\n\n### Option 2: Local Development\n\n**Backend:**\n```bash\ncd api\npip install -r requirements.txt\nuvicorn api.main:app --reload --port 8000\n```\n\n**Frontend:**\n```bash\ncd frontend\npython server.py\n# Visit http://localhost:8080\n```\n\n## 🌐 Deploy to Railway\n\nSee [DEPLOY.md](DEPLOY.md) for complete deployment instructions.\n\n**Quick Steps:**\n1. Push to GitHub\n2. Connect to Railway\n3. Deploy backend + frontend services\n4. Add environment variables\n5. Done! 🎉\n\n## 🔧 Configuration\n\n### Environment Variables\n\n```env\n# Required for web search\nGOOGLE_API_KEY=AIzaSy...\nGOOGLE_CSE_ID=0123456789...\n\n# Optional for chat history\nSUPABASE_URL=https://...\nSUPABASE_KEY=eyJhbGci...\n```\n\n### Get API Keys\n\n1. **OpenAI** (Users provide their own):\n   - https://platform.openai.com/api-keys\n\n2. **Google Search**:\n   - API Key: https://console.cloud.google.com/apis/credentials\n   - CSE ID: https://programmablesearchengine.google.com/\n\n3. **Supabase** (Optional):\n   - https://supabase.com/dashboard\n\n## 📚 API Endpoints\n\n- `POST /api/chat/message` - Send a message\n- `POST /api/chat/stream` - Stream response\n- `POST /api/chat/code` - Execute code\n- `POST /api/documents/upload` - Upload file\n- `POST /api/search/web` - Web search\n- `GET /health` - Health check\n\nFull API docs: `http://localhost:8000/docs`\n\n## 🎨 Why Azazel?\n\n**Supercharging AI Models** - Azazel elevates GPT-4 and legacy models to the next level by integrating:\n- **RAG** - Chat with your documents\n- **Vision** - Analyze images and screenshots\n- **Code Execution** - Run Python code safely\n- **Web Search** - Access real-time information\n- **Multi-modal** - Handle text, images, code, and documents\n\nAll in one beautiful, easy-to-use interface without the heavyweight price tag!\n\n## 🛠️ Built With\n\n- **FastAPI** - Modern, fast Python web framework\n- **LangChain** - AI orchestration and RAG\n- **OpenAI** - GPT-4, Vision, Whisper\n- **Tailwind CSS** - Beautiful, responsive UI\n- **Docker** - Containerization\n- **Railway** - Easy deployment\n\n## 📝 License\n\nMIT License - see [LICENSE](LICENSE) file for details\n\n## 🙏 Acknowledgments\n\n- OpenAI for GPT-4 API\n- FastAPI for amazing web framework\n- Tailwind CSS for beautiful styling\n- LangChain for AI orchestration\n- Railway for easy deployment\n\n---\n\n\n**Built with ❤️ for the AI community**\n\n[⭐ Star on GitHub](https://github.com/your-repo) • [🐛 Report Bug](https://github.com/your-repo/issues) • [✨ Request Feature](https://github.com/your-repo/issues)\n\n\u003c/div\u003e\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsanatren%2Fazazel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsanatren%2Fazazel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsanatren%2Fazazel/lists"}