🌟 TokenPulse Sentiment Agent

Real-time crypto sentiment analysis system with autonomous AI agents. Built with ❤️ by Mavens.

🚀 Quick Start

Prerequisites

• Python 3.10+
• Virtuals API Key (Get from Virtuals Platform)
• Twitter Developer Account

Installation

# Clone repository
git clone 
cd safe-sentiment-agent

# Install dependencies
pip install -r requirements.txt

# Copy environment template
cp .env.example .env

🔧 Configuration

1. Get your Virtuals API key from their developer portal
2. Edit .env file:

VIRTUALS_API_KEY="your_api_key_here"
TWITTER_USERNAME="your_twitter_handle"
TWITTER_PASSWORD="your_twitter_password"

🔐 Twitter Authentication

# Run Twitter authentication script (stores cookies in cookies.json)
python src/agents/twitter_auth.py

🖥️ Running the System

Frontend Dashboard

streamlit run src/frontend/sentiment_dashboard.py

Backend Agent

python src/agents/game_sentiment_agent.py --tokens solana,ethereum

📂 Project Structure

safe-sentiment-agent/
├── src/
│   ├── agents/            # Autonomous agent implementations
│   ├── frontend/          # Streamlit dashboard components
│   └── data/              # Analysis results and historical data
├── requirements.txt       # Python dependencies
└── .env.example           # Environment configuration template

📌 Dependencies Highlights

• Core: transformers, torch, pandas
• Twitter: httpx, tweepy
• Frontend: streamlit, plotly
• Utils: python-dotenv, termcolor