🧠 Mimir

Named after the wise head from Norse mythology, Mimir is an AI-powered intelligence system that aggregates, processes, and distributes critical information across industries.

🌟 Overview

Mimir is an intelligent information aggregation and distribution system that harnesses the power of AI to identify, process, and deliver the most important and urgent information from across various sources. Just as the mythological Mimir possessed infinite wisdom, this system serves as your all-knowing intelligence hub.

🎯 Core Concept

Collect → Process → Distribute

Mimir operates on three fundamental pillars:

• 📡 Information Collection: Aggregate data from multiple sources
• 🤖 AI Processing: Identify critical and time-sensitive information
• 📤 Smart Distribution: Deliver insights to the right channels

🏗️ Architecture

📡 Information Collection

• 🐦 Twitter Monitoring: Real-time tweet collection and analysis
• 📰 RSS Feed Integration: Automated monitoring of news websites
• 💹 Market Data: Historical and real-time price data from crypto exchanges
• 🌐 Web Scraping: Content extraction from various web sources

🤖 AI Processing Engine

• ⚡ Hourly Flash News: Real-time event processing and alerts
• 📊 Daily Digest: Comprehensive daily intelligence reports
• 🎯 Smart Filtering: AI-powered relevance and urgency detection
• 📈 Trend Analysis: Pattern recognition and market insights

📤 Distribution Channels

• 💬 Telegram Bot: Instant notifications and interactive queries
• 🔔 Feishu Bot: Enterprise-grade team collaboration integration
• 📧 Custom Webhooks: Flexible integration with your existing tools

🚀 Quick Start

Prerequisites

• Python 3.8+
• Virtual environment (recommended)

Installation

1. Clone the repository

git clone https://github.com/cctv2206/mimir-opensource.git
cd mimir

2. Set up virtual environment

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

4. Configure environment variables

# Copy and edit the environment configuration
cp .env.example .env
# Edit .env with your API keys and configuration

5. Initialize the database

python -m storage.initialize_supabase

6. Start the server

python run_server.py

📁 Project Structure

mimir/
├── ai/                     # AI processing and analysis
│   ├── daily_digest.py     # Daily intelligence reports
│   ├── hourly_digest.py    # Real-time flash news
│   └── openai_util.py      # AI utilities and prompts
├── cex/                    # Crypto exchange integrations
│   ├── binance_connector.py
│   └── crypto_price_collector.py
├── twitter/                # Twitter monitoring system
│   ├── twitter_monitor_with_supabase.py
│   └── twitter_service.py
├── web/                    # Web scraping and monitoring
│   ├── cointelegraph_monitor.py
│   └── web_extract.py
├── storage/                # Data storage and management
│   ├── supabase_storage.py
│   └── crypto_price_storage.py
├── dispatcher/             # Message routing and distribution
├── tg/                     # Telegram bot integration
├── feishu/                 # Feishu bot integration
└── tests/                  # Test suites

🔧 Configuration

Environment Variables

Create a .env file with the following variables:

# AI Services
OPENAI_API_KEY=your_openai_api_key
DEEPSEEK_API_KEY=your_deepseek_api_key

# Social Media APIs
TWITTER_BEARER_TOKEN=your_twitter_bearer_token
TWITTER_API_KEY=your_twitter_api_key
TWITTER_API_SECRET=your_twitter_api_secret

# Crypto Exchanges
BINANCE_API_KEY=your_binance_api_key
BINANCE_SECRET_KEY=your_binance_secret_key

# Database
SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_key

# Bot Integrations
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
FEISHU_APP_ID=your_feishu_app_id
FEISHU_APP_SECRET=your_feishu_app_secret

🎮 Usage Examples

Starting Information Collection

# Monitor Twitter for specific keywords
python -m twitter.twitter_monitor_with_supabase

# Collect crypto price data
python -m cex.crypto_price_collector

# Monitor web sources
python -m web.cointelegraph_monitor

AI Processing

# Generate hourly digest
python -m ai.run_hourly_digest

# Create daily report
python -m ai.daily_digest

Bot Operations

# Start Telegram bot
python -m tg.tg_bot

# Start Feishu bot
python -m feishu.feishu_bot

🛠️ Development

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📊 Features

• ✅ Real-time information aggregation
• ✅ AI-powered content analysis
• ✅ Multi-platform distribution
• ✅ Crypto market integration
• ✅ Social media monitoring
• ✅ RSS feed processing
• ✅ Telegram bot interface
• ✅ Feishu enterprise integration
• ✅ Configurable alert system
• ✅ Historical data storage

🔮 Roadmap

• Discord Bot Integration
• Slack Workspace Support
• Web Dashboard Interface
• Mobile App Notifications
• Advanced Analytics Dashboard
• Multi-language Support
• Custom Plugin System

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Support

• 📧 Email: kaikaikangkang@gmail.com
• 💬 Issues: GitHub Issues

🙏 Acknowledgments

• Named after Mimir from Norse mythology, the severed head that provided wisdom to Odin
• Built with modern Python technologies and AI capabilities
• Inspired by the need for intelligent information processing in today's data-rich world

---

🧠 Mimir - Where Information Becomes Intelligence