O-RAN × Nephio RAG System

🎯 What is O-RAN × Nephio RAG System?

A cutting-edge AI-powered system that combines advanced Retrieval-Augmented Generation (RAG) technology with specialized knowledge of O-RAN and Nephio ecosystems. Get accurate, contextual answers to complex telecommunications and cloud-native networking questions.

🤖

AI-Powered Q&A

Advanced language models provide accurate, contextual answers based on official documentation.

📚

Official Documentation

Automatically processes and indexes O-RAN and Nephio official sources for reliable information.

🔍

Semantic Search

High-precision vector-based document retrieval finds the most relevant content for your queries.

⚡

Multiple API Modes

Flexible integration options including browser automation, mock mode, and local deployment.

🐳

Container Ready

Complete Docker support with production-ready monitoring and scaling capabilities.

📊

Full Observability

Built-in metrics, logging, health monitoring, and Grafana dashboards for production use.

🚀 Get Started 📖 View on GitHub

🚀 Quick Deployment Guide

Get your O-RAN × Nephio RAG system running in minutes with these simple deployment options.

Quick Demo (Mock Mode)

Perfect for testing and evaluation without API keys - runs in under 5 minutes!

# 1. Clone repository
git clone https://github.com/thc1006/oran-nephio-rag.git
cd oran-nephio-rag

# 2. Install dependencies
pip install -r requirements.txt

# 3. Set mock mode
echo "API_MODE=mock" > .env

# 4. Create test database
python create_minimal_database.py

# 5. Run system
python main.py
                        

Docker Development

Isolated environment with hot reload for development and testing.

# Development environment
docker-compose -f docker-compose.dev.yml up -d

# Check status
docker-compose ps
curl http://localhost:8000/health
                        

Production Deployment

Scalable production setup with monitoring, load balancing, and high availability.

# Production with monitoring
docker-compose -f docker-compose.prod.yml up -d

# Or with full monitoring stack
docker-compose -f docker-compose.monitoring.yml up -d
                        

Cloud Deployment

Deploy to major cloud providers with one-click solutions.

# AWS ECS/Fargate
aws ecr get-login-password | docker login --username AWS
docker build -t oran-rag . && docker push

# Google Cloud Run
gcloud builds submit --tag gcr.io/PROJECT-ID/oran-rag
gcloud run deploy --image gcr.io/PROJECT-ID/oran-rag

# Azure Container Instances  
az container create --name oran-rag --image your-registry/oran-rag
                        

💡 Pro Tip

For production deployments, check out our comprehensive DEPLOYMENT.md guide with Kubernetes configurations, security best practices, and monitoring setup.

✨ Key Features & Capabilities

🧠 Advanced AI Integration

✅ Multiple LLM backends (Claude, Local models)
✅ Browser automation for API access
✅ Configurable temperature and token limits
✅ Async processing support

📊 Production Ready

✅ Horizontal scaling with Docker
✅ Prometheus metrics & Grafana dashboards
✅ Health checks & auto-recovery
✅ Load balancing & high availability

🔧 Technical Specifications

Languages: Python 3.9+
Frameworks: LangChain, FastAPI
Database: ChromaDB (Vector)

Containers: Docker, Kubernetes
Monitoring: Prometheus, Grafana
Security: JWT, HTTPS, Network Policies

Platforms: Linux, macOS, Windows
Cloud: AWS, GCP, Azure
License: Apache 2.0

🎯 Use Cases

🏢 Enterprise Networks

Deploy intelligent Q&A for O-RAN architecture questions, network function scaling, and deployment guidance.

🎓 Training & Education

Interactive learning tool for telecommunications professionals and cloud-native engineers.

🔬 Research & Development

Accelerate R&D with instant access to comprehensive O-RAN and Nephio documentation insights.

📖 Documentation & Resources

🚀 Quick Start

Get up and running in minutes with our comprehensive quick start guide.

Read README

🐳 Deployment

Complete production deployment guide with cloud configurations.

Deployment Guide

🔧 Development

Developer guidance for customization and contribution.

Dev Guide

⚙️ API Modes

Configure different API integration modes for your environment.

API Guide

🔗 External Resources

🌐 O-RAN Alliance

Official O-RAN specifications and standards

Visit O-RAN.org

☸️ Nephio Project

Cloud-native network automation platform

Visit Nephio.org

📊 GitHub Repository

Source code, issues, and contributions

View on GitHub

🤝 Support & Community

Need help? Join our community discussions, report issues, or contribute to the project. We welcome feedback and contributions from telecommunications and cloud-native professionals.

🐛 Report Issues 💬 Discussions 📧 Contact