Netrum AI Agent

Netrum AI Agent is a FastAPI-based backend designed for AI-powered blockchain infrastructure monitoring and automation. It monitors multiple blockchain networks, tracks RPC performance, collects metrics, and generates alerts for infrastructure health.

Base URL

https://agent.netrumlabs.dev

API documentation:

/docs
/redoc

🚀 Quick Start

Need Python 3.11 after setup netrum ai agent

1. Create Virtual Environment

python -m venv venv

2. Activate Virtual Environment

Windows

venv\Scripts\activate

Linux / Mac

source venv/bin/activate

3. Install Dependencies

pip install -r requirements.txt

4. Run the Server

python main.py

Server will start on:

http://127.0.0.1:8040

Swagger API Docs:

http://127.0.0.1:8040/docs

Project Structure

netrum-ai-agent
│
├── agent
│   ├── __init__.py
│   └── agent.py          # AI agent
│
├── ai
│   └── engine.py         # AI Engine
├── api
│   ├── __init__.py
│   ├── agent.py          # Background AI agent
│   ├── node.py           # Background Node API
│   ├── routes.py         # Main API routes
│   └── health.py         # Health check endpoint
│
├── config
│   ├── __init__.py
│   └── settings.py       # Environment configuration
│
├── logo.png              # Agent Logo
├── main.py               # FastAPI application entry point
├── requirements.txt      # Python dependencies
├── .env                  # Environment variables
└── README.md

API Endpoints

GET /health
GET /api/

GET /api/infra/overview
GET /api/infra/anomalies
GET /api/infra/recommendations
GET /api/infra/analysis
GET /api/infra/score

GET /api/agent/info
GET /api/agent/status
GET /api/agent/analyze
GET /api/agent/recommend
GET /api/agent/summary

GET /api/node/status
GET /api/node/latest-block
GET /api/node/gas
GET /api/node/health
GET /api/node/history
GET /api/node/alerts
GET /api/node/metrics
GET /api/node/score

---

Endpoint Use Cases

Endpoint	Description
/health	Server health check
/api/	Basic API service information
/api/infra/overview	Complete AI-powered infrastructure overview
/api/infra/anomalies	Detected infrastructure anomalies
/api/infra/recommendations	AI-generated infrastructure recommendations
/api/infra/analysis	AI network performance analysis
/api/infra/score	Network reliability score (0–100)
/api/agent/info	AI agent metadata and version information
/api/agent/status	AI agent operational status
/api/agent/analyze	AI analysis of monitored network data
/api/agent/recommend	AI infrastructure recommendations
/api/agent/summary	Summary of current infrastructure state
/api/node/status	Multi-chain RPC status and latency
/api/node/latest-block	Latest block height for networks
/api/node/gas	Current network gas prices
/api/node/health	Overall node health summary
/api/node/history	Monitoring history collected by the AI agent
/api/node/alerts	Infrastructure alerts detected by monitoring
/api/node/metrics	Aggregated monitoring metrics and analytics
/api/node/score	Network reliability score based on latency

Features

• FastAPI backend
• AI-powered infrastructure monitoring
• Autonomous background monitoring agent
• Multi-chain RPC monitoring (Ethereum, Base)
• Blockchain node performance tracking
• Latency monitoring and analytics
• Infrastructure anomaly detection
• AI-powered infrastructure analysis
• Automated infrastructure recommendations
• Network reliability scoring
• Monitoring history storage
• Infrastructure metrics analytics
• Swagger API documentation (/docs, /redoc)
• Production-ready deployment

AI Infrastructure Capabilities

Netrum AI Agent automatically:

• Monitors blockchain RPC infrastructure
• Tracks network latency and block synchronization
• Detects infrastructure anomalies
• Generates intelligent infrastructure recommendations
• Computes reliability scores for monitored networks
• Provides a unified infrastructure overview API

Supported Networks

Currently supported:

• Ethereum
• Base

Planned support:

• Arbitrum
• Polygon
• Optimism
• BNB Chain

License

MIT License

NetrumLabs

AI-powered infrastructure for the Web3 ecosystem.