An open-source starter kit, v1.run provides an automated system for comparing npm packages across over 50 categories. It targets developers seeking efficient package discovery and evaluation, offering real-time metrics and AI agent integration to streamline decision-making and development workflows.

How It Works

The project employs a formula-based scoring system that evaluates packages on factors like weekly downloads, bundle size, commit freshness, community engagement (stars, contributors), and code quality (TypeScript, ESM, security). Data is processed by a 'decisions' package, and an MCP server facilitates native integration with AI coding assistants such as Cursor and Claude, enabling them to leverage package search and comparison tools. Search functionality is powered by Typesense, ensuring sub-50ms query responses.

Quick Start & Requirements

• Installation: Clone the repository (git clone https://github.com/your-org/v1.run) and run bun install.
• Prerequisites: Bun v1.2+ is required. A Typesense Cloud account and a Redis instance are necessary. An optional GitHub token (GITHUB_TOKEN) can be provided for higher API rate limits.
• Running: Start the web application with bun run dev:web (accessible at port 3000) and the data sync worker with bun run dev:sync. The MCP server can be launched via npx @packages-run/mcp-server.
• Environment Variables: Configure Typesense connection details (TYPESENSE_HOST, TYPESENSE_PORT, TYPESENSE_PROTOCOL, TYPESENSE_API_KEY) and optionally GITHUB_TOKEN.
• Documentation: API details and example responses are provided within the README.

Highlighted Details

• Automated Comparisons: Scores packages across 50+ categories using weighted factors.
• Real-time Metrics: Tracks downloads, bundle size, maintenance status, and freshness.
• Alternative Discovery: Helps identify suitable replacements for existing packages.
• MCP Server: Integrates package intelligence directly into AI coding assistants.
• Fast Search: Leverages Typesense for sub-50ms search performance.

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or project roadmap were present in the provided README.

Licensing & Compatibility

The project is released under the MIT License, which permits commercial use and modification.

Limitations & Caveats

The project relies on external services (Typesense Cloud, Redis) which require separate setup and potential costs. While a GitHub token is optional, its absence may lead to API rate limiting issues for data fetching. As a starter kit, it may require further development for production-ready deployments.