BashAI — Datathon 2026

Building PS1 of GenAI domain

Overview

BashAI is an intelligent monitoring and analytics platform that aggregates signals across development, HR, product management, and finance domains to provide actionable insights for engineering leadership.

Modules

🤖 Agents

GitHub Agent

• PR Analysis: Review cycle time, review depth, size analysis
• Commit Analysis: After-hours commits, weekend work patterns, activity trends
• Webhook Integration: Real-time processing of GitHub events

Slack Agent

• Multi-channel notification system
• Formatted message blocks with rich formatting
• File upload support for dashboards

Jira Agent

• Issue tracking and analysis
• Sprint metrics aggregation

📊 Intelligence Modules

HR Intelligence

• Burnout Detection: Multi-signal burnout risk assessment
• Engagement Trends: Team health and morale tracking
• Workload Analysis: Sustainable workload monitoring
• Team Aggregation: Per-team metrics and insights

Finance Intelligence

• Engineering ROI: Value delivery metrics
• Cost Monitoring: Budget tracking and utilization
• Risk Radar: Proactive cost anomaly detection
• Feature Costing: Per-feature financial analysis

PM Intelligence

• Delivery Confidence: Feature completion probability
• Scope Creep Detection: Sprint boundary monitoring
• Dependency Risk: External dependency impact analysis

Executive Intelligence ⭐ NEW

• Executive Briefs: Leadership-level status summaries
• Visual Dashboards: 9-panel comprehensive analytics
• Status Assessment: Three-tier health indicators (ON TRACK / AT RISK / OFF TRACK)
• Cross-domain Aggregation: Unified view across HR, PM, and Finance

API Server

FastAPI-based webhook and command server running on port 8000.

Slack Slash Commands

/hr-intelligence              # HR insights and burnout analysis
/finance-intelligence         # Financial metrics and ROI
/pm-feature-confidence        # Delivery confidence analysis
/pm-scope-creep              # Scope creep detection
/pm-dependency-risk          # External dependency risk
/executive-brief [--viz]     # Executive summary (with optional dashboard)
/executive-dashboard         # Visual dashboard only

REST Endpoints

GET  /api/executive/signals     # Get executive signals JSON
GET  /api/executive/brief       # Get executive brief blocks
POST /webhook                   # GitHub webhook receiver

Environment Variables

# GitHub
GITHUB_TOKEN=ghp_...

# Slack
SLACK_BOT_TOKEN=xoxb-...
SLACK_CHANNEL_ID=C...
SLACK_HR_INTELLIGENCE_CHANNEL_ID=C...
SLACK_BURNOUT_RADAR_CHANNEL_ID=C...
SLACK_FINANCE_CHANNEL_ID=C...
SLACK_PM_CHANNEL_ID=C...
SLACK_EXECUTIVE_CHANNEL_ID=C...
SLACK_SIGNING_SECRET=...

# AI/LLM
FEATHERLESS_API_KEY=rc_...

# Jira (optional)
JIRA_API_TOKEN=...
JIRA_EMAIL=...
JIRA_BASE_URL=https://yourcompany.atlassian.net
# (or) JIRA_DOMAIN=yourcompany.atlassian.net

# Jira → Slack monitor (optional)
JIRA_MONITOR_ENABLED=true
JIRA_BOARD_ID=123
# If set, pending tickets are pulled from this query.
# If not set, pending tickets are pulled from active+future sprints on JIRA_BOARD_ID.
JIRA_PENDING_JQL=project = ABC AND resolution = EMPTY ORDER BY updated DESC
SLACK_JIRA_CHANNEL_ID=C...
JIRA_MONITOR_INTERVAL_SECONDS=120

Installation

# Install dependencies
pip install -r requirements.txt

# Set up environment
cp .env.example .env
# Edit .env with your tokens

# Run server
python api_server.py

Deployment

Server runs on http://0.0.0.0:8000. Use ngrok or similar for webhook testing:

ngrok http 8000

Configure GitHub webhook URL: https://your-ngrok-url.ngrok.io/webhook

Architecture

┌─────────────────┐
│  GitHub Events  │
└────────┬────────┘
         │
         v
┌─────────────────┐      ┌──────────────┐
│   API Server    │─────>│  Agents      │
│   (FastAPI)     │      │  - GitHub    │
└────────┬────────┘      │  - Slack     │
         │               │  - Jira      │
         │               └──────────────┘
         v
┌─────────────────┐      ┌──────────────┐
│  Event Store    │      │ Intelligence │
│  (SQLite)       │─────>│  - HR        │
└─────────────────┘      │  - Finance   │
         │               │  - PM        │
         │               │  - Executive │
         v               └──────┬───────┘
┌─────────────────┐            │
│  Aggregation    │<───────────┘
│  (Scheduled)    │
└────────┬────────┘
         │
         v
┌─────────────────┐
│  Slack Alerts   │
│  & Dashboards   │
└─────────────────┘

Key Features

✅ Real-time GitHub webhook processing
✅ Multi-domain intelligence aggregation
✅ Proactive risk detection (burnout, cost, scope)
✅ Executive dashboards with visualization
✅ Slack-native interface with slash commands
✅ Background job scheduling for periodic analysis
✅ SQLite event store for historical tracking

Documentation

• HR Setup Guide
• Jira Setup Guide
• Slash Commands Setup (Full Guide)
• Slash Commands Quick Reference
• Slash Commands Visual Guide
• Executive Module

License

MIT