Spaces:
Sleeping
Sleeping
| title: FathomDeepResearch | |
| emoji: 🧮 | |
| colorFrom: blue | |
| colorTo: red | |
| sdk: docker | |
| app_port: 7860 | |
| pinned: false | |
| license: apache-2.0 | |
| short_description: Advanced research AI with web search capabilities | |
| # 🔬 FathomDeepResearch | |
| Advanced AI research agent powered by Fathom-Search-4B and Fathom-Synthesizer-4B models. This app provides deep research capabilities with real-time web search and intelligent synthesis. | |
| ## 🚀 Features | |
| - **🧠 Advanced Reasoning**: Powered by Fathom-R1-14B for sophisticated thinking | |
| - **🔍 Real-time Web Search**: Integrated search across multiple sources | |
| - **📊 Intelligent Synthesis**: Combines search results into coherent answers | |
| - **🎨 Rich UI Components**: Streamlined chat interface with progress tracking | |
| - **⚡ Fast Performance**: Optimized for Hugging Face Spaces | |
| ## 🛠️ How to Use | |
| 1. **Enter your research question** in the text box | |
| 2. **Click "Research"** to start the deep research process | |
| 3. **Watch progress** as the AI searches and synthesizes information | |
| 4. **Get comprehensive answers** with source citations | |
| ## 💡 Example Questions | |
| - "What are the latest AI developments in 2024?" | |
| - "DeepResearch on climate change solutions" | |
| - "UPSC 2025 preparation strategy" | |
| - "Comparative analysis of electric vehicle adoption" | |
| ## 🔧 Technical Details | |
| ### Models Used | |
| - **Fathom-Search-4B**: For web search and retrieval | |
| - **Fathom-Synthesizer-4B**: For answer synthesis | |
| - **Fathom-R1-14B**: For reasoning and planning | |
| ### Architecture | |
| - **Backend**: FastAPI with Gradio integration | |
| - **Frontend**: React-based chat interface | |
| - **Search**: Multi-source web search with Serper API | |
| - **Deployment**: Docker containers optimized for HF Spaces | |
| ## 📋 Requirements | |
| - Python 3.10+ | |
| - Transformers 4.35+ | |
| - Gradio 4.0+ | |
| - FastAPI | |
| - Hugging Face Transformers | |
| ## 🌐 Deployment | |
| This app is deployed on Hugging Face Spaces using Docker. The setup includes: | |
| - Automatic model downloading | |
| - Environment configuration | |
| - Error handling and fallbacks | |
| - Multi-modal capabilities | |
| ## 📖 License | |
| Apache 2.0 License - See LICENSE file for details | |
| ## 🤝 Contributing | |
| Contributions are welcome! Please feel free to submit a Pull Request. | |
| ## 📞 Support | |
| For issues or questions: | |
| - Check the docs folder for detailed documentation | |
| - Open an issue on the repository | |
| - Contact the development team | |
| ## 🧩 Building the Docker image locally (private Hugging Face repo) | |
| If the source is in a private Hugging Face Space, provide a token when building the image. The Dockerfile clones the repository during build using the build-arg `HF_API_TOKEN`. | |
| Examples (PowerShell): | |
| Provide token as a build-arg (less secure, visible in image history): | |
| ```powershell | |
| docker build -t fathom-deploy --build-arg HF_API_TOKEN=hf_xxx . | |
| ``` | |
| Using BuildKit and a secret (recommended): | |
| ```powershell | |
| $env:DOCKER_BUILDKIT=1; docker build --secret id=hf_token,src=$env:USERPROFILE\.hf_token -t fathom-deploy . | |
| ``` | |
| Place your token in a file (e.g. %USERPROFILE%\.hf_token) containing only the token string, then reference it with `--secret`. You would need to adapt the Dockerfile to read from `/run/secrets/hf_token` if you choose this approach. | |
| Note: If the repository is public you can omit the build-arg and the Dockerfile will clone anonymously. |