projectbridge 0.1.1

Analyze your GitHub repos against job descriptions and get concrete project ideas to close skill gaps.

ProjectBridge

Analyze your GitHub repos against job descriptions and get concrete project ideas to close skill gaps.

What should I build next to move toward the role I want?

Runs entirely on your machine. No accounts. No uploads.

---

Quickstart

pip install projectbridge

Try the built-in example (no GitHub token or AI provider required):

projectbridge analyze --example

Sample output (trimmed)

{
  "schema_version": "1.0",
  "strengths": [
    { "name": "Python", "category": "language" },
    { "name": "React", "category": "framework" },
    { "name": "Docker", "category": "infrastructure" }
  ],
  "gaps": [
    { "name": "TypeScript", "category": "language" },
    { "name": "Kubernetes", "category": "infrastructure" },
    { "name": "PostgreSQL", "category": "tool" }
  ],
  "recommendations": [
    {
      "title": "Build a REST API with Django",
      "description": "Create a RESTful API using Django REST Framework...",
      "skills_addressed": ["Django", "REST API"],
      "estimated_scope": "medium"
    },
    {
      "title": "Deploy a containerized app with Kubernetes",
      "description": "Dockerize a web app and deploy to a local cluster...",
      "skills_addressed": ["Docker", "Kubernetes"],
      "estimated_scope": "medium"
    }
  ]
}

Run with your own data:

projectbridge analyze --job job.txt --github-user your-username

Export as Markdown:

projectbridge export --job job.txt --github-user your-username

Install from source

git clone https://github.com/akuligowski9/project-bridge
cd project-bridge
pip install -e ./engine

---

What It Does

ProjectBridge reads a job description, scans your GitHub profile, and produces a structured analysis with:

• Strengths — skills you already demonstrate
• Gaps — skills the job requires that your repos don't show
• Recommendations — concrete project ideas to close those gaps

Key capabilities:

• 4 AI providers — OpenAI, Anthropic, Ollama, or no-AI heuristic fallback
• 97+ framework/tool detections — from React to Terraform
• 22 curated project templates — scoped as small, medium, or large
• Desktop app — Tauri + Svelte 5 UI for visual exploration
• Structured JSON output — schema v1.0, ready for CI/CD or downstream tools
• File-based caching — skip redundant GitHub API calls
• Privacy-first — tokens stay local, no telemetry, no uploads

---

Architecture

Tauri Desktop App (Svelte 5 + TypeScript)
        ↓
  Python Engine (pip install projectbridge)
        ↓
  Analysis Pipeline
    ├── GitHub repo scanner
    ├── Job description parser
    ├── Skill matcher
    └── Recommendation engine
        ↓
  AI Provider Interface (pluggable)
    ├── OpenAI  ├── Anthropic  ├── Ollama  ├── None (heuristic)
        ↓
  Structured JSON Output (schema v1.0)

---

AI Providers

AI is used in a bounded, optional layer. Core analysis runs without it.

Provider	Install	Usage
None (default)	—	--no-ai or omit provider flags
OpenAI	pip install projectbridge[openai]	--provider openai
Anthropic	pip install projectbridge[anthropic]	--provider anthropic
Ollama	— (uses stdlib urllib)	--provider ollama

Prompts and outputs are visible and editable. See engine/projectbridge/ai/prompts/.

---

Desktop App

The Tauri desktop app provides a visual interface for running analyses and exploring results.

cd app
npm install
npm run dev

Requires the Python engine to be installed (pip install -e ./engine).

---

Privacy

ProjectBridge is intentionally not SaaS.

• GitHub tokens never leave your machine
• Private repositories remain private
• No telemetry or analytics
• All outputs stored locally

---

Contributing

ProjectBridge is designed to be forked and extended. Common areas:

• AI provider integrations
• Language/framework detection
• Recommendation improvements
• Export formats
• UI improvements

See CONTRIBUTING.md.

---

License

MIT License — see LICENSE.