Apppublic

Maxx45654/ricci-reserve-protocol

sourceHugging Faceupdated 10mo agoView on Hugging Face

0likes

App README

AxiomTestnet - Ricci Flow Consensus Engine

Real-time oracle monitoring with geometric consensus using Ricci Flow curvature.

Features

—🔄 Real-time Metrics - Lyapunov exponent, Coherence, Total Energy
—📊 Live Price Feeds - CoinGecko/Binance integration
—🎨 Interactive Dashboard - Recharts with smooth animations
—🔐 Blockchain Integration - Sepolia testnet support
—🚨 Alert System - Native, email, and Telegram notifications
—🤖 Multi-Agent Consensus - 9 agents on 3x3 lattice with Fisher metrics

Architecture

Single Docker Container
├── Node.js Dashboard (port 7860)
│   ├── Express server
│   ├── Socket.io WebSocket
│   ├── React frontend (Recharts)
│   └── Alert services
├── Python Engine (subprocess)
│   ├── Ricci Flow engine
│   ├── Multi-agent consensus
│   ├── Live price feeds
│   └── Metrics calculation
└── Persistent Storage
    └── Metrics accumulation

Environment Variables

Required environment variables (set in HuggingFace Secrets):

# Dashboard
NODE_ENV=production
PORT=7860
USE_ENGINE_WORKER=true

# Price Feed
PRICE_FEED_COIN=ethereum
USE_LIVE_PRICES=true

# Blockchain (Sepolia)
SEPOLIA_RPC_URL=https://sepolia.infura.io/v3/YOUR_KEY
SEPOLIA_PRIVATE_KEY=0x...
ORACLE_REGISTRY_ADDRESS=0x...

# Alerts
TELEGRAM_BOT_TOKEN=your_token
TELEGRAM_CHAT_ID=your_chat_id
GMAIL_USER=your_email@gmail.com
GMAIL_PASSWORD=your_app_password

Deployment

Deployed on HuggingFace Spaces with Docker runtime.

Local Testing

bash

docker build -f Dockerfile.huggingface -t axiom-test .
docker run -p 7860:7860 --env-file .env axiom-test

Visit: http://localhost:7860

Documentation

—HUGGINGFACE_DEPLOYMENT_GUIDE.md - Setup instructions
—HUGGINGFACE_DEPLOYMENT_CHECKLIST.md - Verification steps
—DEPLOYMENT_SUMMARY.md - Complete overview

Support

—HuggingFace Docs: https://huggingface.co/docs/hub/spaces
—Docker Spaces: https://huggingface.co/docs/hub/spaces-docker