---
title: Web3 Research Co-Pilot
emoji: 🚀
colorFrom: blue
colorTo: green
sdk: docker
app_file: app.py
dockerfile: Dockerfile
license: mit
tags:
- cryptocurrency
- blockchain
- defi
- ai-research
- ollama
- llama3
pinned: false
header: default
short_description: AI-powered crypto research with real-time blockchain data
suggested_hardware: t4-medium
---

# Web3 Research Co-Pilot 🚀

An AI-powered cryptocurrency research assistant that provides real-time blockchain analytics, DeFi insights, and market intelligence using Llama 8B and comprehensive API integrations.

## ✨ Features

- **🤖 AI-Powered Analysis**: Uses Llama 8B model via Ollama for intelligent responses
- **🔗 Real-Time Data**: Integrates with CryptoCompare, DeFiLlama, Etherscan APIs
- **🛡️ AI Safety**: Built-in content filtering and safety guardrails
- **📊 Interactive UI**: Modern web interface with dark/light themes
- **⚡ Streaming Responses**: Real-time progress updates during analysis
- **🔄 Comprehensive Tools**: 5+ specialized cryptocurrency research tools

## 🛠️ Technical Stack

- **Backend**: FastAPI with Python 3.11
- **AI Model**: Llama 3 8B via Ollama (local inference)
- **Frontend**: Vanilla JavaScript with modern CSS
- **APIs**: CryptoCompare, DeFiLlama, Etherscan, CoinGecko
- **Safety**: Custom AI safety module with content filtering
- **Deployment**: Docker for HuggingFace Spaces

## 🚀 Usage

Ask questions like:
- "Analyze Bitcoin price trends and institutional adoption patterns"
- "Compare top DeFi protocols by TVL and yield metrics"
- "What are the current Ethereum gas fees?"
- "Track whale movements in Bitcoin today"

## 🔧 Development

### Local Setup
```bash
# Clone the repository
git clone https://huggingface.co/spaces/your-username/web3-research-copilot
cd web3-research-copilot

# Install dependencies
pip install -r requirements.txt

# Start Ollama (in separate terminal)
ollama serve
ollama pull llama3:8b

# Run the application
python app.py
```

### Docker Deployment
```bash
# Build and run with Docker
docker build -f Dockerfile.hf -t web3-copilot .
docker run -p 7860:7860 -p 11434:11434 web3-copilot
```

## 📁 Project Structure

```
├── app.py                 # Main FastAPI application
├── templates/             # HTML templates
├── static/               # CSS and JavaScript files
├── src/
│   ├── agent/            # AI research agent
│   ├── tools/            # API integration tools
│   └── utils/            # Configuration and safety
├── Dockerfile.hf         # HuggingFace Spaces Docker config
└── requirements.txt      # Python dependencies
```

## 🛡️ AI Safety Features

- Input sanitization and validation
- Rate limiting protection
- Content filtering for harmful requests
- Response safety validation
- Comprehensive logging for monitoring

## 📊 Supported APIs

- **CryptoCompare**: Price data and market statistics
- **DeFiLlama**: Protocol TVL and DeFi analytics  
- **Etherscan**: Ethereum network data and gas prices
- **CoinGecko**: Cryptocurrency market data
- **Custom Chart Data**: Historical price analysis

## 🤝 Contributing

This project implements responsible AI practices and focuses on legitimate cryptocurrency research and education.

## 📄 License

MIT License - see LICENSE file for details

---

Built with ❤️ for the crypto research community