openhub

mcp
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • eval() — Dynamic code execution via eval() in app/main.py
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Terminal discovery hub and package manager for AI coding tools, MCP servers, and agent skills. Built with Python & Textual

README.md

OpenHub

A keyboard-first, terminal user interface (TUI) discovery hub and package installer for AI coding tools, skills, and agents.

Built with Python, Textual, and SQLite — zero configuration required out of the box.


Requirements & Platform Support

  • Python: 3.10+
  • Operating Systems: Linux, macOS, Windows (PowerShell / Windows Terminal)

Ecosystem & AI Agent Compatibility

OpenHub exports tools using the Universal Open Agent Skills Standard (SKILL.md), making exported tools instantly usable across modern AI coding assistants and IDEs:

AI Tool / Agent IDE Supported Export Integration Path
OpenCode Yes ./.opencode/skills/ & ~/.config/opencode/
Claude Code / Desktop Yes ./.agents/skills/ & ~/.agents/skills/
Cursor Editor Yes ./.agents/skills/
Windsurf / Cascade Yes ./.agents/skills/
Roo Code / Cline Yes ./.agents/skills/
AutoGen / CrewAI Yes Standard SKILL.md format

Quick Start

Install via pipx (Recommended)

pipx install git+https://github.com/24KaratAu/openhub.git
openhub

Install via pip

pip install git+https://github.com/24KaratAu/openhub.git
openhub

Local Development

git clone https://github.com/24KaratAu/openhub.git
cd openhub
pip install -e .
openhub

Features & Architecture

  1. Dashboard-Centric Catalog: Displays scannable catalog panels showing trending repositories, recent releases, fast-growing utilities, and hidden gems.
  2. Intent-Driven Fuzzy Search: Pressing / or S opens a Spotlight-style command palette dropdown. Typo-tolerant matching runs locally using rapidfuzz across names, descriptions, topics, and use cases.
  3. Curated Collections: Browse curated workflows such as "AI Engineer Starter Pack", "Claude Desktop Servers", "Cursor Editor Skills", or "Python Toolkit".
  4. Scannable Metadata Cards: Repository items render with visual quality ratings (★★★★★), language tags, and difficulty levels.
  5. Instant Boot & Background Sync: Boots instantly (< 100ms) from local SQLite cache while fresh GitHub data syncs silently in background threads.
  6. Universal Skill Export: Press E to export 1-click SKILL.md prompt instructions directly to ./.agents/skills/ and ./.opencode/skills/.
  7. Activity History Log: Logs all actions (Installed, Exported, Failed, Removed) to a persistent local SQLite database.

Technical Documentation & Heuristics

OpenHub relies on deterministic algorithms rather than subjective metrics to score quality, classify difficulty levels, and curate sections.

Read the full technical documentation in HOW_IT_WORKS.md.


Keyboard Shortcuts

Shortcut Action
H Navigate to Home Dashboard
B Browse by Use Cases
C Browse Curated Collections
S / / Toggle Spotlight Search palette
I View Installed packages
E Export Skill directly (SKILL.md & Agent definition)
L View Operation History logs
R Refresh cache and sync repositories
F Cycle implementation type filters (in Browse mode)
Enter Show Details / Install selected repository
Esc Exit details / Cancel modal / Close Search
Q Quit application

Codebase Layout

openhub/
│
├── README.md               # Quickstart guide, system requirements & documentation
├── HOW_IT_WORKS.md          # Technical engine & scoring documentation
├── pyproject.toml          # Package configuration & openhub CLI entrypoint
├── install.sh              # Shell installer script
├── run.py                  # Standalone runner script
├── requirements.txt        # Package dependencies (textual, httpx, rapidfuzz)
├── .github/
│   └── workflows/
│       ├── ci.yml          # Automated test workflow on PRs
│       └── release.yml     # Automated GitHub release workflow
│
└── app/
    ├── __init__.py
    ├── main.py             # Main application orchestrator & background worker loop
    ├── cache.py            # SQLite database connection manager
    ├── client.py           # GitHub API client & caching
    ├── classifier.py       # Heuristic classification & Quality Score algorithms
    ├── exporter.py         # Universal SKILL.md & Agent exporter
    ├── installer.py        # Asynchronous installation runner subprocess
    │
    ├── screens/            # UI Screen views
    │   ├── home.py         # Home Dashboard view
    │   ├── browse.py       # Use-case browse list view
    │   ├── collections.py  # Curated Lists view
    │   ├── search.py       # Spotlight overlay dropdown view
    │   ├── details.py      # Markdown readme preview & Install confirm overlays
    │   └── history.py      # Operations activity log view
    │
    └── widgets.py          # Custom scannable card layout elements

Reviews (0)

No results found