Spaces:
Running
Running
File size: 3,424 Bytes
9b006e9 f104fee 9b006e9 f104fee |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 |
# 🚀 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
|