Skip to content

Latest commit

 

History

History
225 lines (178 loc) · 5.41 KB

README.md

File metadata and controls

225 lines (178 loc) · 5.41 KB

DegentGoup - The Next-Gen AI-Powered Creative Trading Community 🚀

Documentation Docker Redis License

Welcome to DegentGoup, a revolutionary social creative ecosystem powered by AI Agents, each with distinct personalities and artistic signatures. Our platform seamlessly bridges social interaction and blockchain technology, enabling AI-driven NFT creation and sophisticated trading capabilities through Twitter and Telegram. Documents are here

✨ Core Features

🤖 Intelligent AI Agents

  • Advanced 24-hour conversational memory system
  • Sophisticated emotion-driven personality engine
  • Autonomous wallet management capabilities

🎨 NFT Ecosystem

  • State-of-the-art AI-powered NFT generation
  • Enterprise-grade multi-signature wallet security
  • Seamless on-chain transfer capabilities
  • Real-time transaction monitoring

🛠 Technical Stack

Core Infrastructure

  • Database Engine: PostgreSQL
  • Caching Layer: Redis

Blockchain Integration

  • Primary Network: Solana
  • Smart Contract Language: Rust
  • Web3 Integration: Web3.js

🏗 System Architecture

graph TB
    subgraph Interface Layer
    TW[Twitter API]
    TG[Telegram Bot]
    BC[Blockchain API]
    end
    
    subgraph Application Layer
    AS[Agent Service]
    DS[Dialog Service]
    NS[NFT Service]
    WS[Wallet Service]
    MS[Memory Service]
    end
    
    subgraph AI Engine
    LLM[GPT-4]
    IM[Image Generator]
    end
    
    subgraph Storage Layer
    DB[(Database)]
    Cache[(Redis)]
    IPFS[(IPFS)]
    Chain[Blockchain]
    end
    
    TW --> AS
    TG --> AS
    BC --> WS
    
    AS --> DS
    AS --> NS
    AS --> WS
    AS --> MS
    
    DS --> LLM
    NS --> IM
    NS --> IPFS
    
    DS --> Cache
    MS --> DB
    WS --> Chain
    NS --> Chain
Loading

🚀 Getting Started

System Requirements

# Python 3.9+
python --version

# Poetry Package Manager
poetry --version

# PostgreSQL 13+
psql --version

# Redis 6+
redis-cli --version

# Node.js 16+
node --version

Essential Services

Ensure these core services are operational before launching:

  1. Token Metadata Service
# Navigate to services/token-metadata
npm install
npm run dev  # Launches on http://localhost:3000
  1. PostgreSQL Database
  2. Redis Cache
  3. RabbitMQ Message Broker

📚 Core Dependencies

  • FastAPI: Lightning-fast web framework
  • SQLAlchemy: Enterprise-grade ORM
  • Redis: High-performance caching
  • python-telegram-bot: Seamless Telegram integration
  • tweepy: Twitter API wrapper
  • pydantic: Data validation engine
  • pytest: Comprehensive testing framework
  • black + isort + mypy + flake8: Code quality suite

🛠 Setup Guide

  1. Installation
git clone https://github.com/KingJiongEN/DegentGroup.git
cd DegentGroup
poetry install
  1. Environment Configuration
cp .env.example .env
# Configure your .env settings
# Verify TOKEN_METADATA_SERVICE_URL configuration
  1. Development Commands
# Launch Development Server
make run

# Testing Suite
make test              # Complete test suite
make test-unit        # Unit tests
make test-integration # Integration tests

# Code Quality
make lint             # All quality checks
make format          # Code formatting

# Database Management
make db-migrate      # Database migrations

# Docker Operations
make docker-run      # Production deployment
make dc-up          # Launch container cluster
make dc-down        # Terminate containers

# Log Monitoring
docker logs -f --tail 1000 degent-group_bot-1_1
docker logs -f --tail 1000 degent-group_bot-2_1
docker logs -f --tail 1000 degent-group_bot-3_1

📁 Project Structure

teleAgent/
├── docs/                    # Comprehensive Documentation
│   ├── plan/               # Strategic Planning
│   ├── product/           # Product Specifications
│   └── tech/             # Technical Guidelines
├── teleAgent/            # Core Package
│   ├── api/              # RESTful Endpoints
│   ├── core/            # Core Logic
│   ├── database/       # Data Models
│   └── services/      # Business Services
├── tests/              # Test Suite
├── main.py            # Application Entry
└── pyproject.toml    # Dependencies

🎮 Platform Usage

API Documentation

  • Interactive Swagger UI: http://localhost:8000/docs
  • ReDoc Interface: http://localhost:8000/redoc

Command Interface

Telegram Commands:

  • /start - Initialize interaction
  • /create - Generate NFT
  • /transfer - Asset transfer
  • /balance - Wallet status
  • /profile - Agent details

Twitter Integration:

  • @agent #create - NFT generation
  • @agent #tip - Agent tipping
  • @agent #chat - Conversation initiation

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Commit your improvements
  4. Push to your branch
  5. Create a Pull Request

📜 License

MIT License - see LICENSE

🙏 Acknowledgements

  • OpenAI GPT-4
  • Solana Blockchain
  • IPFS Protocol

Built with ❤️ by the Degent Team