BAM

Behavioural Activity Monitor

Intelligence beyond statistics

A futuristic behavioural intelligence dashboard that transforms GitHub contribution activity into adaptive developer personas, contribution rhythm analytics, productivity diagnostics and visual behavioural insights.

---

✦ System Overview

BAM is not a traditional GitHub statistics dashboard.

It is a behavioural intelligence system designed to analyze :

• coding rhythm
• consistency behaviour
• contribution psychology
• burst productivity
• activity momentum
• development discipline

using GitHub GraphQL contribution data.

The interface was designed with cinematic system aesthetics inspired by :

• futuristic intelligence terminals
• glassmorphism dashboards
• adaptive monitoring systems
• atmospheric UI environments
• sci-fi operating systems

---

✦ Core Intelligence Features

🧠 Behavioural Personas Dynamic persona generation based on contribution behaviour. Examples: Consistent Maintainer Burst Coder Adaptive Developer Night Architect Momentum Builder	📈 Activity Timeline Advanced timeline visualization using: contribution spikes rhythm mapping intensity tracking behavioural frequency
🌌 Behavioural Diagnostics Developer analysis system including: streak intelligence consistency scoring productivity rhythm contribution density	📱 Responsive Interface Fully adaptive responsive system: mobile navigation dynamic sidebar animated interactions scroll intelligence adaptive scaling

---

✦ Interface Preview

✦ Core Intelligence Interface

Primary behavioural analysis dashboard

---

✦ Behavioural Timeline Engine

Contribution rhythm and productivity frequency mapping

---

✦ Contribution Heatmap Matrix

Visual behavioural density and activity distribution system

---

✦ Behavioural Analysis Engine

BAM interprets GitHub activity patterns through behavioural heuristics.

Example Logic

Behaviour Pattern	Generated Persona
High consistency & long streaks	Consistent Maintainer
Intense sporadic activity bursts	Burst Coder
Mixed adaptive rhythms	Adaptive Developer
Late-night activity concentration	Night Architect

---

✦ Technology Stack

Frontend	Backend	Visualization	Deployment
React	Flask	Recharts	Vercel
Vite	Python	Tailwind CSS	Render
Framer Motion	GitHub GraphQL API	Glassmorphism UI	Cloud Deployment

---

✦ System Architecture

    GitHub GraphQL API
          ↓
       Flask Backend
          ↓
 Behavioural Analysis Engine
          ↓
      React Intelligence UI
          ↓
 Dynamic Persona Visualization

---

✦ API Endpoint

Analyze Developer Behaviour

GET /analyze/<github_username>

Example

/analyze/Keertilata20

Sample Response

{
  "persona": "Consistent Maintainer",
  "consistency": 96,
  "peak_time": "Night",
  "streak": 98
}

---

✦ Local Development

Clone Repository

git clone https://github.com/Keertilata20/Behavioural-Activity-Monitor.git

---

Frontend Setup

cd bam-ui
npm install
npm run dev

---

Backend Setup

cd backend
pip install -r requirements.txt
python app.py

---

✦ Environment Variables

Create a .env file inside:

bam-ui/backend

Add:

GITHUB_TOKEN=your_github_token

---

✦ Live Deployment

Frontend

Launch BAM Dashboard

Backend API

Render Backend

---

✦ Design Philosophy

BAM was designed around the idea that contribution data is not merely statistical.

It reflects:

• discipline
• momentum
• burnout cycles
• behavioural adaptation
• productivity psychology

The interface intentionally avoids conventional analytics aesthetics in favour of atmospheric behavioural intelligence visualization.

---

✦ Future Enhancements

• AI-generated behavioural reports
• contribution prediction models
• repository intelligence
• weekly behavioural summaries
• developer comparison systems
• animated activity replay system
• exportable analytics reports

---

✦ Author

Keerti Lata Choudhury

Designed and engineered as a behavioural intelligence system for developer analytics.

---