projectbridge 0.1.1
Analyze your GitHub repos against job descriptions and get concrete project ideas to close skill gaps.
Requires Python: >=3.10
Keywords: developer-tools, skill-gap, career, github, portfolio, job-search

# ProjectBridge

[![CI](https://github.com/akuligowski9/project-bridge/actions/workflows/test.yml/badge.svg)](https://github.com/akuligowski9/project-bridge/actions/workflows/test.yml)
[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

**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.

![ProjectBridge Dashboard](docs/images/screenshot.png)

---

## Quickstart

```bash
pip install projectbridge
```

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

```bash
projectbridge analyze --example
```

<details>
<summary>Sample output (trimmed)</summary>

```json
{
  "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"
    }
  ]
}
```

</details>

Run with your own data:

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

Export as Markdown:

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

### Install from source

```bash
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.

```bash
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](docs/CONTRIBUTING.md).

---

## License

MIT License — see [LICENSE](LICENSE).