OSSIntel

Open Source Intelligence Platform

OSSIntel transforms GitHub profiles, repositories, and npm packages into actionable insights.

Unlike GitHub, which primarily shows activity, OSSIntel helps answer questions such as:

• Is this project healthy?
• Can I trust this package?
• How impactful is this maintainer?
• What are the biggest risks?
• Where should contributors start?

Goals

• Provide deterministic OSS analytics
• Surface meaningful insights using AI
• Help maintainers, contributors, recruiters, and developers make better decisions
• Build a reusable OSS intelligence engine

Architecture

      GitHub APIs    npm Registry    StackExchange API
           │              │                 │
      ┌────────────┐ ┌────────────┐ ┌──────────────┐
      │ github-    │ │  npm       │ │ stackoverflow│
      │ normalizer │ │            │ │              │
      └────────────┘ └────────────┘ └──────────────┘
           │              │                 │
           └──────────────┼─────────────────┘
                          │
            ┌──────────────────────────┐
            │ scoring                  │
            └──────────────────────────┘
                          │
            ┌──────────────────────────┐
            │ insights                 │
            └──────────────────────────┘
                          │
                   Next.js Dashboard

Tech Stack

Layer	Technology
Monorepo	pnpm workspaces + Turborepo
Language	TypeScript (strict)
Web	Next.js 15 (App Router)
Styling	Tailwind CSS v4 + shadcn/ui
Testing	Vitest
Docs	Fumadocs + Typedoc
Linting	Biome
Release	Changesets
CI	GitHub Actions

Packages

@ossintel/github-normalizer

Fetches and normalizes GitHub data into a stable domain model.

@ossintel/npm

Fetches and normalizes npm Registry data: package metadata, download statistics, maintainer information, and user profiles.

@ossintel/stackoverflow

Fetches and normalizes StackExchange API data: user profiles, reputation, badges, and top tag expertise.

@ossintel/scoring

Deterministic, modular scoring engine with pillar architecture (Maintainer, Contributor, Organization, Influence) and capability-specific scoring (Package Publishing, Knowledge Sharing). Additive evidence bonuses from npm and Stack Overflow never reduce scores.

@ossintel/insights

Transforms metrics into findings, recommendations, and AI-ready summaries. Depends on scoring and normalizer packages.

@app/web

Next.js dashboard — the presentation layer. Business logic lives in the packages above.

Dependency chain: normalizers (github, npm, stackoverflow) → scoring → insights → web

Principles

• Deterministic first
• AI augments, never replaces
• Typed everywhere
• Small reusable packages
• Testable business logic
• UI remains thin

Ecosystem Impact Engine

OSSIntel includes a custom Ecosystem Impact Engine that maps developer reach across external projects. It classifies contributions dynamically (code vs. documentation vs. test suites) and weights them by target repository stargazers (importance Tier) to produce an Ecosystem Contribution Score.

Dataflow Pipeline

   [User Input] ──► [github-normalizer] ──► [PR Classification] ──► [scoring Engine]
                           │                                              │
                    (Fetches PRs &                                 (Weights Tiers &
                    Repo Stargazers)                               Quality Factors)
                                                                          │
                                                                          ▼
                                                                  [Ecosystem Score]
                                                                          │
                                                                          ▼
                                                                 [Next.js Dashboard]

Search Query Syntax

OSSIntel parses a variety of input query formats using the @ossintel/input-parser engine, allowing users to quickly analyze repositories, developers, organizations, and npm packages.

Supported Formats

Format	Target Type	Example Input
GitHub Repository	Repository	react18-tools/kosha, https://github.com/react18-tools/kosha
GitHub Organization	Organization	org:react18-tools, organizations/react18-tools, https://github.com/orgs/react18-tools
GitHub User	User / Unknown	user:octocat, octocat, https://github.com/octocat
NPM Package	npm Package	npm:lodash, @babel/core, https://www.npmjs.com/package/lodash
NPM User	npm Developer	npm:~isaacs, ~isaacs, https://www.npmjs.com/~isaacs
Stack Overflow	Stack Overflow User	so:12345, https://stackoverflow.com/users/12345/some-user
VS Code Extension	Marketplace Extension	vscode:publisher/extension
Medium Blogs	Medium User	medium:@username, https://medium.com/@username
LeetCode Profiles	LeetCode User	leetcode:username

AI-assisted Development

This project itself demonstrates AI-assisted software engineering.

The development workflow includes:

1. Brainstorming
2. PRD creation
3. Architecture design
4. Domain modeling
5. Task decomposition
6. AI-assisted implementation
7. Human review and refinement

Roadmap

• Developer Intelligence
• Repository Intelligence
• Package Intelligence
• Organization Intelligence
• GitHub App
• CLI
• VS Code Extension

with 💖 by Mayank Kumar Chaudhari