AIRA (AI-Powered Incident Response Agent) is an intelligent system that monitors, analyzes, and responds to incidents in real-time using advanced AI capabilities.

• 🔍 Real-time Incident Monitoring: Continuous monitoring of logs and system events
• 🧠 AI-Powered Analysis: Uses Groq LLM for intelligent incident analysis
• 🔄 Automated Response: Suggests and executes remediation actions
• 📊 Interactive Dashboard: Real-time visualization of incidents and system health
• 🔐 Secure Authentication: JWT-based authentication system
• 🐙 GitHub Integration: Automatic issue creation and tracking
• 💬 Slack Notifications: Real-time alerts to your team
• 🔌 MCP Integration: Model Context Protocol for enhanced AI capabilities

• Python 3.11+
• Node.js 18+
• Docker (optional, for containerized deployment)
• Groq API key
• GitHub Personal Access Token

1. Clone the repository

git clone https://github.com/YOUR_USERNAME/aira.git
cd aira

2. Setup environment variables

cp .env.example .env
# Edit .env with your credentials

3. Start with Docker (Recommended)

make build
make up
make health

4. Or start manually

Backend:

cd backend
pip install -r requirements.txt
uvicorn main:app --reload --host 0.0.0.0 --port 8000

Frontend:

cd frontend
npm install
npm run dev

5. Access the application

• Frontend: http://localhost:5173
• Backend API: http://localhost:8000
• API Docs: http://localhost:8000/docs

AIRA is optimized for deployment on Render.com with one-click setup.

📖 See RENDER_DEPLOYMENT.md for complete deployment guide.

1. Fork this repository
2. Sign up at render.com
3. Click "New" → "Blueprint"
4. Connect your repository
5. Configure environment variables
6. Click "Apply"

What gets deployed:

• ✅ Backend API (Python/FastAPI)
• ✅ Frontend (React/Vite)
• ✅ PostgreSQL Database
• ✅ Redis Cache
• ✅ MCP Servers (optional)

Pricing:

• Free tier available
• Production: ~$31/month

• Docker: See DEPLOYMENT.md
• AWS/GCP/Azure: See DEPLOYMENT.md
• Kubernetes: See DEPLOYMENT.md

• Quick Start Guide
• User Guide
• API Documentation
• Deployment Guide
• Render Deployment ⭐
• Troubleshooting
• Contributing

┌─────────────────┐
│   Frontend      │
│  (React/Vite)   │
└────────┬────────┘
         │
         ↓
┌─────────────────┐      ┌──────────────┐
│   Backend API   │◄────►│   Redis      │
│  (FastAPI)      │      │   Cache      │
└────────┬────────┘      └──────────────┘
         │
         ├──────────────┐
         ↓              ↓
┌─────────────────┐  ┌──────────────┐
│   PostgreSQL    │  │  MCP Servers │
│   Database      │  │  (GitHub,    │
└─────────────────┘  │   Context)   │
                     └──────────────┘

Backend:

• FastAPI (Python web framework)
• SQLAlchemy (ORM)
• LangGraph (AI agent framework)
• Groq (LLM provider)
• Redis (caching)
• PostgreSQL (database)

Frontend:

• React 18
• TypeScript
• Vite
• Tailwind CSS
• WebSocket (real-time updates)

Infrastructure:

• Docker & Docker Compose
• Render (recommended hosting)
• GitHub Actions (CI/CD)

Required environment variables:

# API Keys
GROQ_API_KEY=your_groq_api_key
GITHUB_TOKEN=your_github_token
GITHUB_REPO=owner/repository

# Database (automatically set by Render)
DATABASE_URL=postgresql://...
REDIS_URL=redis://...

# Optional
SLACK_WEBHOOK_URL=https://hooks.slack.com/...
LOG_LEVEL=INFO

See .env.example for complete configuration.

# Run backend tests
cd backend
pytest

# Run frontend tests
cd frontend
npm test

# Run integration tests
make test

AIRA includes built-in monitoring endpoints:

• Health: GET /health
• Metrics: GET /metrics
• Ready: GET /ready

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

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

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions
• 📧 Email: support@aira-project.com

• Groq for fast LLM inference
• Render for excellent hosting platform
• LangChain for AI framework
• All our contributors and users

• Multi-tenant support
• Advanced analytics dashboard
• Custom incident rules engine
• Mobile app
• Integration with more monitoring tools
• AI model fine-tuning

Built with ❤️ by the AIRA Team

⭐ Star us on GitHub if you find AIRA useful!