Spaces:
Running
Running
| # 🚀 Web3 Research Co-Pilot | |
| AI-powered cryptocurrency research assistant with comprehensive Web3 data analysis capabilities. | |
| ## Features | |
| - **LangChain AI Agent**: Advanced query processing with Google Gemini | |
| - **Real-time Data**: CoinGecko, DeFiLlama, Etherscan integration | |
| - **Interactive UI**: Gradio-based chat interface with visualizations | |
| - **AIRAA Integration**: Research data forwarding to external platforms | |
| - **Production Ready**: Comprehensive error handling and async architecture | |
| ## Quick Start | |
| ### 1. Environment Setup | |
| ```bash | |
| export GEMINI_API_KEY="your_gemini_api_key" | |
| export ETHERSCAN_API_KEY="your_etherscan_key" # Optional | |
| export COINGECKO_API_KEY="your_coingecko_key" # Optional | |
| ``` | |
| ### 2. Installation | |
| ```bash | |
| pip install -r requirements.txt | |
| ``` | |
| ### 3. Launch | |
| ```bash | |
| python launch.py | |
| ``` | |
| ## API Keys | |
| - **GEMINI_API_KEY** (Required): [Get from Google AI Studio](https://makersuite.google.com/app/apikey) | |
| - **ETHERSCAN_API_KEY** (Optional): [Get from Etherscan.io](https://etherscan.io/apis) | |
| - **COINGECKO_API_KEY** (Optional): [Get from CoinGecko](https://www.coingecko.com/en/api/pricing) | |
| ## Architecture | |
| ``` | |
| ├── app.py # Main Gradio application | |
| ├── src/ | |
| │ ├── agent/ # LangChain AI agent | |
| │ ├── tools/ # Web3 data tools | |
| │ ├── api/ # External integrations | |
| │ └── utils/ # Configuration & utilities | |
| └── launch.py # Launch script | |
| ``` | |
| ## Usage Examples | |
| - "What is the current price of Bitcoin?" | |
| - "Analyze Ethereum's DeFi ecosystem" | |
| - "Show me gas prices and network stats" | |
| - "Research the top DeFi protocols by TVL" | |
| ## Deployment | |
| Configured for HuggingFace Spaces with automatic dependency management. | |
| --- | |
| **Built with minimal, expert-level code and production-grade error handling.** | |
| ## Features | |
| - **Real-time Market Analysis**: CoinGecko, DeFiLlama, Etherscan integration | |
| - **AI Research Agent**: Powered by Google Gemini | |
| - **Interactive Interface**: Modern Gradio UI | |
| - **Data Visualization**: Price charts and market overviews | |
| - **AIRAA Integration**: Webhook support for external platforms | |
| ## Quick Start | |
| 1. **Clone and Setup** | |
| ```bash | |
| git clone <repository-url> | |
| cd web3-research-agent | |
| pip install -r requirements.txt | |
| ``` | |
| 2. **Environment Configuration** | |
| ```bash | |
| cp .env.example .env | |
| # Edit .env with your API keys | |
| ``` | |
| 3. **Run Application** | |
| ```bash | |
| python app.py | |
| ``` | |
| ## Required API Keys | |
| - `GEMINI_API_KEY`: Google Gemini AI (required) | |
| - `ETHERSCAN_API_KEY`: Ethereum blockchain data | |
| - `COINGECKO_API_KEY`: Cryptocurrency market data (optional) | |
| - `AIRAA_WEBHOOK_URL`: External integration (optional) | |
| ## Deployment | |
| ### Docker | |
| ```bash | |
| docker build -t web3-research-agent . | |
| docker run -p 7860:7860 --env-file .env web3-research-agent | |
| ``` | |
| ### Hugging Face Spaces | |
| Upload repository to HF Spaces with environment variables configured. | |
| ## Architecture | |
| - **Agent**: LangChain-based research agent with memory | |
| - **Tools**: Modular API integrations (CoinGecko, DeFiLlama, Etherscan) | |
| - **UI**: Gradio interface with chat and visualization | |
| - **Cache**: Optimized caching for API responses | |
| - **Integration**: AIRAA webhook support | |
| ## Usage Examples | |
| - "Bitcoin price analysis and market sentiment" | |
| - "Top DeFi protocols by TVL" | |
| - "Ethereum gas prices and network stats" | |
| - "Compare BTC vs ETH performance" | |
| Built with ❤️ for Web3 research | |