Airflow Copilot

Chat‑driven orchestration for Apache Airflow inside Microsoft Teams

✨ Why Copilot?

• Conversational control — trigger DAGs, view runs, pause/resume schedules, inspect logs.
• LLM‑powered intelligence — plug in OpenAI · Gemini · Claude · Groq.
• RBAC aware — honours Airflow permissions when calling its REST API.
• Persistent memory — summaries & checkpoints stored in PostgreSQL (LangGraph).
• Deployment parity — same image on Docker Compose, Kubernetes, ECS.

---

🚀 Quick Start (local)

Full guide → Getting Started

# Clone & copy env template
git clone https://github.com/NikhilSuthar/airflow-copilot.git
cd airflow-copilot
cp .env.example .env            # fill in keys / secrets

# Launch Copilot + ngrok + bot‑updater
docker compose -f docker-compose.local.yml up -d

1. Ensure Airflow (≥ 2.5) is reachable at ${AIRFLOW_BASE_URL}
2. Ngrok publishes an HTTPS tunnel
3. bot‑updater patches the Azure Bot endpoint automatically
4. Open Microsoft Teams → chat with Airflow Copilot 🚀

---

🎬 Demo

🚀 See Airflow Copilot in action inside Microsoft Teams — from updating credentials to triggering DAGs and viewing logs.

📺 Watch the Demo

🧾 Or explore the same examples → Chat Examples

---

🧠 Architecture

Read the deep dive → Architecture

---

📦 Deployment Options

Mode	Guide	Best For
Docker Compose (local)	Local Deployment	Dev / PoC
Docker Compose (prod)	Docker based Deployment	Small teams
Kubernetes	Kubernetes based Deployment	Cloud & scale

Each mode uses the same .env. Bring your own DB & TLS.

---

⚙️ Configuration

All runtime settings are environment variables.
See the reference → Environment Variables

---

📄 License

Licensed under the MIT License © 2025 Nikhil Suthar.

---