🚀 XMRT Ecosystem

Full-stack decentralized autonomous organization (DAO) with AI-powered agents and blockchain integration

Features • Getting Started • Documentation • Contributing

📖 About

XMRT Ecosystem is a comprehensive DAO platform that combines AI-driven automation, multi-agent coordination, and blockchain technology to create a self-governing, intelligent ecosystem. Built with ElizaOS for autonomous operations and Ethereum smart contracts for decentralized governance.

🎯 Key Highlights

🤖 AI-Powered Agents: 93+ scheduled automations handling community engagement, analytics, security, and governance
🔄 Multi-Agent Coordination: Sophisticated agent orchestration with memory, learning, and task management
⚡ Real-time Analytics: Comprehensive monitoring and reporting systems
🔐 Blockchain Integration: Smart contracts deployed on Ethereum Sepolia testnet
🌐 Full-Stack Platform: Modern web dashboard with Next.js + React + Supabase
🛡️ Security First: Automated security scans, code analysis, and threat detection

✨ Features

🧠 ElizaOS Integration

Autonomous reward tracking and distribution
Context-aware decision making
Self-learning and adaptive behavior
Character-based AI personalities

🤝 Community Automation

GitHub Triage: Automatic issue labeling and prioritization
PR Review: AI-powered code review and feedback
Discussion Management: Automated community engagement
Security Scanning: Malicious content detection and removal

📊 Analytics & Monitoring

Real-time metrics collection and visualization
GitHub activity tracking and insights
System health monitoring
Performance analytics dashboard

🏛️ DAO Governance

Proposal creation and voting system
Token-based governance mechanisms
Transparent decision-making process
Smart contract integration

🔧 Edge Functions

143 deployed Supabase Edge Functions
Task orchestration and automation
System status monitoring
API integrations

🎨 Unified Dashboard

Reward claims interface
Wallet integration (CashDapp)
Analytics visualization
Agent activity monitoring

🛠️ Technology Stack

Frontend

Framework: Next.js 14 with App Router
UI Library: React 18
Styling: TailwindCSS
State Management: React Hooks + Context API

Backend

Runtime: Node.js 20+, Python 3.11+
Database: Supabase (PostgreSQL)
Edge Functions: Supabase Functions
APIs: REST + GraphQL

AI & Automation

AI Engine: ElizaOS
LLM Integration: OpenAI GPT-4
Agent Framework: Custom multi-agent system
Scheduling: Cron-based automation (93 scheduled functions)

Blockchain

Network: Ethereum Sepolia Testnet
Smart Contracts:
- XMRT Token: 0x77307DFbc436224d5e6f2048d2b6bDfA66998a15
- IP-NFT: 0x9de91fc136a846d7442d1321a2d1b6aaef494eda
Framework: Hardhat

DevOps & Infrastructure

CI/CD: GitHub Actions (26 workflows)
Containerization: Docker + Docker Compose
Deployment: Vercel (frontend), Supabase (backend)
Monitoring: Custom health checks + logging

🚀 Getting Started

Prerequisites

Node.js 20+ and npm/pnpm
Python 3.11+
Docker (optional, for containerized development)
Git
Supabase CLI (for local development)

Installation

Clone the repository

git clone https://github.com/DevGruGold/XMRT-Ecosystem.git
cd XMRT-Ecosystem

Install dependencies

# Node.js dependencies
npm install

# Python dependencies
pip install -r requirements.txt

Environment Setup

# Copy example environment files
cp .env.example .env
cp .env.auth.example .env.auth

# Edit .env with your configuration
# Required variables:
# - SUPABASE_URL
# - SUPABASE_KEY
# - GITHUB_TOKEN
# - OPENAI_API_KEY

Database Setup

# Initialize Supabase locally (optional)
supabase init
supabase start

# Run migrations
supabase db push

Run Development Server

# Start frontend
npm run dev

# Start backend (in another terminal)
python enhanced_main.py

Access the Application
- Frontend: http://localhost:3000
- Supabase Studio: http://localhost:54323
- API: http://localhost:5000

Quick Start with Docker

# Build and run all services
docker-compose up -d

# View logs
docker-compose logs -f

# Stop services
docker-compose down

📁 Project Structure

XMRT-Ecosystem/
├── .github/
│   └── workflows/          # GitHub Actions (26 automated workflows)
├── agents/                 # AI agent definitions and configurations
├── api/                    # API endpoints and routes
├── app/                    # Next.js application (frontend)
├── supabase/
│   ├── functions/          # Edge Functions (143 deployed)
│   └── migrations/         # Database migrations
├── contracts/              # Smart contracts (Solidity)
├── scripts/                # Utility and deployment scripts
├── monitoring/             # Health checks and logging
├── docs/                   # Additional documentation
├── config/                 # Configuration files
├── enhanced_main.py        # Main backend application
├── package.json            # Node.js dependencies
├── requirements.txt        # Python dependencies
└── README.md               # This file

Key Files

enhanced_main.py: Main backend server with multi-agent coordination
enhanced_autonomous_controller.py: Agent orchestration and task management
analytics_system.py: Real-time metrics collection and analysis
github_manager.py: GitHub API integration and automation
agents_config.py: Agent personalities and behaviors

🏗️ Architecture

System Components

┌─────────────────────────────────────────────────────────────┐
│                        Frontend (Next.js)                   │
│  ┌──────────────┐  ┌──────────────┐  ┌─────────────────┐  │
│  │  Dashboard   │  │    Wallet    │  │   Analytics     │  │
│  └──────────────┘  └──────────────┘  └─────────────────┘  │
└────────────────────────┬────────────────────────────────────┘
                        │ REST/GraphQL API
┌────────────────────────┴────────────────────────────────────┐
│                   Backend (Python/Node.js)                  │
│  ┌──────────────────────────────────────────────────────┐  │
│  │         Multi-Agent Coordinator (ElizaOS)            │  │
│  │  ┌──────────┐  ┌──────────┐  ┌───────────────────┐  │  │
│  │  │Analytics │  │Community │  │  Governance Agent │  │  │
│  │  │  Agent   │  │  Agent   │  │                   │  │  │
│  │  └──────────┘  └──────────┘  └───────────────────┘  │  │
│  └──────────────────────────────────────────────────────┘  │
└────────────────────────┬────────────────────────────────────┘
                        │
        ┌───────────────┼───────────────┐
        │               │               │
┌───────┴──────┐ ┌──────┴──────┐ ┌─────┴──────┐
│   Supabase   │ │   GitHub    │ │ Blockchain │
│  (Database)  │ │     API     │ │  (Sepolia) │
└──────────────┘ └─────────────┘ └────────────┘

Agent Workflow

Scheduler triggers scheduled functions
Coordinator dispatches tasks to appropriate agents
Agents execute tasks with context and memory
Learning System analyzes outcomes and improves
Analytics collects metrics and generates insights
Frontend displays results in real-time

📚 Documentation

Deployment Guide: Production deployment instructions
Development Guide: Local development setup
Contributing Guidelines: How to contribute
Changelog: Version history and updates
API Documentation: API endpoints and usage

Additional Resources

📊 Supabase Dashboard: View functions and logs
🔐 GitHub Actions: CI/CD workflows
💬 Discussions: Community discussions
📈 Issues: Bug reports and features

🧪 Development

Running Tests

# Run all tests
npm test

# Run Python tests
pytest

# Run specific test suite
npm test -- agents

Code Quality

# Lint code
npm run lint
pylint **/*.py

# Format code
npm run format
black .

# Type checking
npm run type-check
mypy .

Building for Production

# Build frontend
npm run build

# Build Docker image
docker build -t xmrt-ecosystem .

🚢 Deployment

Supabase Edge Functions

# Deploy all functions
supabase functions deploy

# Deploy specific function
supabase functions deploy function-name

Vercel (Frontend)

# Deploy to production
vercel --prod

# Or push to main branch for automatic deployment

Smart Contracts

# Deploy to testnet
cd contracts
npx hardhat run scripts/deploy.js --network sepolia

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Quick Contribution Guide

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

Code Standards

Follow existing code style
Add tests for new features
Update documentation
Ensure CI passes

📊 Project Stats

Total Functions: 143 deployed edge functions
Scheduled Automations: 93 active scheduled functions
GitHub Workflows: 26 automated workflows
Smart Contracts: 2 deployed on Sepolia
Agent Personalities: Multiple AI characters
Automation Coverage: 65% of operations automated

📜 License

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

📞 Contact & Community

GitHub: @DevGruGold
Issues: GitHub Issues
Discussions: GitHub Discussions

🙏 Acknowledgments

ElizaOS: AI agent framework
Supabase: Backend infrastructure
OpenAI: LLM capabilities
Ethereum: Blockchain infrastructure
Community Contributors: Thank you!

Made with ❤️ by the XMRT Community

⬆ Back to Top

Name		Name	Last commit message	Last commit date
Latest commit History 3,696 Commits
.devcontainer		.devcontainer
.github		.github
activity_logs		activity_logs
agent_cycles		agent_cycles
agents		agents
api		api
app		app
apps/web/pages/dashboard		apps/web/pages/dashboard
backend		backend
bots		bots
characters		characters
config		config
contracts		contracts
docs		docs
economics		economics
enhanced-agents		enhanced-agents
enhanced		enhanced
enhancements		enhancements
gem_configs		gem_configs
health_checks		health_checks
integrations		integrations
logs		logs
mcp-integration		mcp-integration
monitoring		monitoring
n8n_workflows		n8n_workflows
public		public
python_service		python_service
reports		reports
scripts		scripts
security_audits		security_audits
src		src
supabase		supabase
templates		templates
test		test
tests		tests
xmrt_apps		xmrt_apps
.env.auth.example		.env.auth.example
.env.enhanced		.env.enhanced
.env.example		.env.example
.env.render		.env.render
.flake8		.flake8
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
.vercelignore		.vercelignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
DEPLOYMENT.md		DEPLOYMENT.md
DEPLOYMENT_DUAL.md		DEPLOYMENT_DUAL.md
DEPLOYMENT_FIX_TRIGGER.md		DEPLOYMENT_FIX_TRIGGER.md
DEPLOYMENT_INSTRUCTIONS_ENHANCED.md		DEPLOYMENT_INSTRUCTIONS_ENHANCED.md
DEPLOYMENT_MARKER.md		DEPLOYMENT_MARKER.md
DEPLOYMENT_SUMMARY.md		DEPLOYMENT_SUMMARY.md
DEPLOY_TRIGGER.md		DEPLOY_TRIGGER.md
DEVELOPMENT.md		DEVELOPMENT.md
Dockerfile		Dockerfile
ENHANCED_DEPLOYMENT.md		ENHANCED_DEPLOYMENT.md
EXECUTIVE_SUMMARY.md		EXECUTIVE_SUMMARY.md
FINAL_DEPLOYMENT_STATUS.md		FINAL_DEPLOYMENT_STATUS.md
LICENSE		LICENSE
MINER_LEADERBOARD.md		MINER_LEADERBOARD.md
Procfile		Procfile
README.md		README.md
README_SLACK_INTEGRATION.md		README_SLACK_INTEGRATION.md
README_VERCEL.md		README_VERCEL.md
RENDER_ENVIRONMENT_SETUP.md		RENDER_ENVIRONMENT_SETUP.md
RENDER_GEVENT_FIX.md		RENDER_GEVENT_FIX.md
VERCEL_MIGRATION_GUIDE.md		VERCEL_MIGRATION_GUIDE.md
WORKFLOW_STATUS.md		WORKFLOW_STATUS.md
activate_enhancements.py		activate_enhancements.py
activity_monitor_api.py		activity_monitor_api.py
advanced_analytics_engine.py		advanced_analytics_engine.py
agent_github_integration.py		agent_github_integration.py
agent_webhook_handler.py		agent_webhook_handler.py
agents_config.py		agents_config.py
ai_tool_framework.py		ai_tool_framework.py
analytics_system.py		analytics_system.py
api_docs_generator.py		api_docs_generator.py
app.py.backup		app.py.backup
autonomous_controller.py		autonomous_controller.py
autonomous_core.py		autonomous_core.py
autonomous_learning_core.py		autonomous_learning_core.py
brightdata_mcp_integration.py		brightdata_mcp_integration.py
chat_system.py		chat_system.py
community_intelligence_system.py		community_intelligence_system.py
deployment_fix_script.py		deployment_fix_script.py
deployment_health_check.py		deployment_health_check.py
docker-compose.dev.yml		docker-compose.dev.yml
docker-compose.yml		docker-compose.yml
ecosystem.config.js		ecosystem.config.js
eliza-test-file.md		eliza-test-file.md
enhanced_api_endpoints.py		enhanced_api_endpoints.py
enhanced_autonomous_controller.py		enhanced_autonomous_controller.py
enhanced_chat_system.py		enhanced_chat_system.py
enhanced_frontend_integration.js		enhanced_frontend_integration.js
enhanced_main.py		enhanced_main.py
enhanced_main_with_mcp.py		enhanced_main_with_mcp.py
enhanced_multi_agent_coordinator.py		enhanced_multi_agent_coordinator.py
fixed_api_routes.py		fixed_api_routes.py
github_manager.py		github_manager.py
gunicorn.conf.py		gunicorn.conf.py

License

DevGruGold/XMRT-Ecosystem

Folders and files

Latest commit

History

Repository files navigation

🚀 XMRT Ecosystem

📖 About

🎯 Key Highlights

✨ Features

🧠 ElizaOS Integration

🤝 Community Automation

📊 Analytics & Monitoring

🏛️ DAO Governance

🔧 Edge Functions

🎨 Unified Dashboard

🛠️ Technology Stack

Frontend

Backend

AI & Automation

Blockchain

DevOps & Infrastructure

🚀 Getting Started

Prerequisites

Installation

Quick Start with Docker

📁 Project Structure

Key Files

🏗️ Architecture

System Components

Agent Workflow

📚 Documentation

Additional Resources

🧪 Development

Running Tests

Code Quality

Building for Production

🚢 Deployment

Supabase Edge Functions

Vercel (Frontend)

Smart Contracts

🤝 Contributing

Quick Contribution Guide

Code Standards

📊 Project Stats

📜 License

📞 Contact & Community

🙏 Acknowledgments

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors 4

Uh oh!

Languages

Packages