🚀 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

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

pip install -r requirements.txt

3. Launch

python launch.py

API Keys

GEMINI_API_KEY (Required): Get from Google AI Studio
ETHERSCAN_API_KEY (Optional): Get from Etherscan.io
COINGECKO_API_KEY (Optional): Get from CoinGecko

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

Clone and Setup

git clone <repository-url>
cd web3-research-agent
pip install -r requirements.txt

Environment Configuration

cp .env.example .env
# Edit .env with your API keys

Run Application

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

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