MoltHub is a public registry for Moltbot agent skills and system lore, enabling developers to publish, version, and search reusable components. It targets users of the Moltbot agent framework, offering a fast, CLI-friendly platform with advanced features like vector search and moderation hooks, streamlining agent development and knowledge sharing.

How It Works

The platform utilizes TanStack Start (React, Vite/Nitro) for its web application, backed by Convex for database, file storage, and HTTP actions, including GitHub OAuth for authentication. Search functionality is powered by OpenAI embeddings (text-embedding-3-small) integrated with Convex's vector search capabilities, providing semantic search over skills and lore. This architecture offers a scalable, serverless backend with modern frontend development practices.

Quick Start & Requirements

Local development requires Bun and the Convex CLI. Installation involves bun install, followed by running the web app (bun run dev) and the Convex backend (bunx convex dev) in separate terminals. GitHub OAuth setup is necessary, involving creating a GitHub OAuth App and configuring environment variables like AUTH_GITHUB_ID, AUTH_GITHUB_SECRET, VITE_CONVEX_URL, and OPENAI_API_KEY. Detailed setup instructions and environment variable configurations are provided.

Highlighted Details

• Supports publishing and versioning of agent skills (SKILL.md + files) and system lore (SOUL.md).
• Features semantic search via OpenAI embeddings and Convex vector indexing, moving beyond keyword limitations.
• Integrates with Nix package manager through metadata.moltbot.nix for bundling skills, CLIs, and configurations.
• Includes optional install telemetry, configurable via an environment variable.

Maintenance & Community

The provided README does not detail specific contributors, community channels (like Discord or Slack), or roadmap information.

Licensing & Compatibility

The repository's README does not specify a software license. This lack of information presents a significant caveat for potential adoption, particularly regarding commercial use or integration with closed-source projects.

Limitations & Caveats

The primary limitation is the absence of explicit licensing information, hindering assessment of usage rights. Local development setup requires specific tooling (Bun, Convex CLI) and careful configuration of numerous environment variables, including API keys for GitHub OAuth and OpenAI.