v0.1 · OPEN SOURCE

✦ Sanskrit: “The Eye” · An internal OS for organizations

NETRA The AI System for Organizations

Netra brings total clarity to your organization. It turns scattered activity — commits, tickets, messages — into a queryable knowledge graph so you can see your engineering system clearly.

🚀 Start Building Learn More →
  • ✦ GitHub native
  • ✦ Neo4j graph
  • ✦ FastAPI backend
↻ LIVE GRAPH — GitHub Activity

✦ The Vision

What Is Netra?

Named after the Sanskrit word for “The Eye,” Netra is an internal OS that provides divine clarity by mapping every commit, ticket, and message into a connected, timestamped Reality Graph.

🧠

Connect the Dots

Stop jumping between GitHub, Jira, Slack, and dashboards. The Reality Graph stitches everything together so you can ask causal questions in plain language.

⚡

Answer in Seconds

“What code changed before the payment service broke?” “Who really owns the auth module?”

No more hours of manual digging.

🔮

Predict & Prevent

Understand system dynamics. Spot neglected modules, single points of failure, and knowledge silos before they become incidents.

🚀

Onboard in Days, Not Weeks

New engineers can explore the graph, see who changed what, and understand service dependencies without bothering 10 people.

⚡ The Problem

Why I Built This

Three frustrations that every engineering team knows too well.

01

🧩 Onboarding Takes Forever

New engineers spend weeks guessing who owns which files and how services connect. The graph shows everything instantly.

02

🚨 Incident Response Is Slow

When something breaks, you waste hours jumping between tools. The graph traces the causal chain in seconds.

03

📊 Decisions Are Blind

Is the billing module neglected? Who's the only person who understands the legacy auth system? The graph gives you data, not guesses.

⚙️ Core Concept

How It Works

Every piece of data becomes a node. Every action becomes a timestamped relationship.

📦 Nodes = Everything

  • 👤 Person
  • 📦 Commit
  • 📄 File
  • 🔀 Pull Request
  • 🎫 Issue
  • 🚀 Deploy
  • 💬 Slack Message

🔗 Relationships = Actions

  • ✍️ COMMITTED_BY
  • 📝 MODIFIES
  • 🔗 PART_OF
  • 💬 MENTIONED_BY
  • ⚡ TRIGGERED_BY
(Commit)-[:COMMITTED_BY]->(Person)
(Commit)-[:MODIFIES]->(File)
(PR)-[:PART_OF]->(Commit)

🧠 What This MVP Does

📥Ingestion

Python script fetches GitHub commits via API

💾Storage

Neo4j stores Person, Commit, File nodes

🔍Querying

FastAPI endpoint accepts Cypher queries → JSON results

📊Visualization

Neo4j Browser lets you explore the graph visually

terminal — ingest
# Ingest commits from the last 30 days
$ docker compose exec api python scripts/ingest_github.py

🛠️ Stack

Built for Scale

Purpose-built tools for connected data, rapid prototyping, and production readiness.

🟢Neo4jGraph database · Cypher
⚡FastAPIPython · Async · Auto‑docs
🐙GitHub APIPyGithub · OAuth
🐳Docker ComposeOne‑command local dev
🐍PythonData · API · Connectors
📦PyGithubGitHub REST client

🔎 Ask Anything

Query Examples

No need to be a Cypher expert — ask normal questions and get answers.

📊 “How many commits are there?”

Returns total commit count across all branches.

🏆 “Who are the top contributors?”

Lists authors ranked by commit volume.

📁 “Which files changed recently?”

Shows files modified in the last 7 days.

👤 “Who changed pyproject.toml?”

Finds everyone who touched that file.

📅 “Commits from the last 7 days”

Filters commits by timestamp.

🔗 “Show me the graph around auth.py”

Returns all commits, authors, and related files.

⚡ Also supports raw Cypher for power users

🚀 Get Started

Setup in 5 Minutes

Clone, configure, run — and start exploring your graph.

STEP 1

📥 Clone & Install

Clone the repo and copy the environment template.

shell
$ git clone https://github.com/Pr1ncePandey/AI-Operating-System-for-Organizations.git
$ cp .env.example .env
STEP 2

🔑 Configure

Add your GitHub token, repo owner, and repo name.

.env
GH_TOKEN=ghp_xxxxxxxx
GITHUB_OWNER=myorg
GITHUB_REPO=myrepo
STEP 3

🐳 Spin Up Services

Docker Compose starts Neo4j + FastAPI with one command.

shell
$ docker compose up -d
STEP 4

📥 Ingest Data

Fetch commits and build your graph.

shell
$ docker compose exec api python scripts/ingest_github.py
🎉DONE — Explore at http://localhost:8000

Open Neo4j Browser at http://localhost:7474 (neo4j / password) and run your first Cypher query.

cypher
MATCH (c:Commit)-[:MODIFIES]->(f:File)
RETURN c, f
LIMIT 50

🧪 Prototype

Current Limitations

This is v0.1 — built to prove the concept. Here's what's not yet supported.

  • No pull requests, issues, or releases (only commits)
  • No CI/CD data or test results
  • No other data sources (Jira, Slack, etc.)
  • No user authentication or multi-tenancy
  • No web UI (only API + Neo4j Browser)
  • No natural language queries (you write Cypher)

💡 That's intentional — prove the core first, then expand

🧭 Philosophy

Data Has a Natural Graph Structure

Your codebase, project management, communication, and infrastructure are all graphs. Treating them as flat tables is the bottleneck.

📂CodebaseFiles · Commits · People
📋Project ManagementTickets · Sprints · Dependencies
💬CommunicationMessages · Threads · Reactions
🌐InfrastructureServices · Deployments · Alerts
Netra isn't about fancy ML — it's about providing the drishti (vision) to understand the structure of how organizations actually work.— drishti · sanskrit · sight / insight

✦ Total clarity awaits

Ready to Build Your Netra Graph?

Clone the repo, spin up the stack, and start exploring your engineering system with total clarity.

📦 Clone on GitHub 📖 Read Setup Guide 𝕏 Follow on Twitter
  • ✦ MIT License
  • ✦ Open Source
  • ✦ Built by Prince Pandey