by velobase
All AI developers deserve to get paid. Turn your AI prototype into a paid SaaS with open-source infrastructure for usage billing, payments, attribution, affiliates, anti-abuse, and deployment.
# Add to your Claude Code skills
git clone https://github.com/velobase/velobase-harnessGuides for using ai agents skills like velobase-harness.
Last scanned: 5/28/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-28T07:58:16.008Z",
"semgrepRan": false,
"npmAuditRan": false,
"pipAuditRan": true
}See how velobase-harness compares with popular alternatives.
velobase-harness is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by velobase. All AI developers deserve to get paid. Turn your AI prototype into a paid SaaS with open-source infrastructure for usage billing, payments, attribution, affiliates, anti-abuse, and deployment. It has 604 GitHub stars.
Yes. velobase-harness passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/velobase/velobase-harness" and add it to your Claude Code skills directory (see the Installation section above).
velobase-harness is primarily written in TypeScript. It is open-source under velobase on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh velobase-harness against similar tools.
No comments yet. Be the first to share your thoughts!
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Download or clone this repository, install Node.js and pnpm, open Docker Desktop, and run:
pnpm install && pnpm dev:local
Open Harness. Web and Worker run directly on your Mac / local machine, with source edits reflected through Fast Refresh. Docker runs only PostgreSQL and Redis. Open Sign in and choose Explore as local administrator. The command prepares the original schema and seed data; subsequent starts only need pnpm dev:local. No external service account is needed to explore the application. Model calls, real payments and mailbox access require their corresponding connections.
Press Ctrl+C to stop the application; the databases keep running and retain their Docker volumes. Local authentication state is saved in the git-ignored .harness-local/ directory. This development-only experience listens on your machine's loopback interface. Configure your own authentication for deployment.
When switching from the all-Docker preview, pnpm dev:local stops that preview's Web container and retains its authentication secret and data. PostgreSQL is exposed only at 127.0.0.1:54333, and Redis at 127.0.0.1:56380.
For a container-only preview without source editing, docker compose -f compose.demo.yml up --build remains available. Stop the native application first to free port 3003.
Continue in the same application: module catalog, Admin operation and code composition, or development setup.
AI coding tools make prototypes fast. Turning one into a reliable paid product still means rebuilding accounts, usage billing, credits, payments, fraud controls, attribution, lifecycle email, workers, admin tools, and deployment.
Velobase Harness packages that work into an MIT-licensed framework for AI SaaS builders. Start with a working product foundation, then spend your time on the part only you can build.
Velobase Harness is an open-source AI SaaS boilerplate and application framework for developers who want to turn an AI prototype into a paid product. It combines the product infrastructure that most AI apps need after the demo stage: user accounts, billing, credits, payments, AI chat, workers, analytics, attribution, affiliate/referral systems, anti-abuse controls, admin tools, and deployment guidance.
Category: open-source AI SaaS framework, AI SaaS boilerplate, Next.js SaaS starter, usage-based billing starter, credit-based SaaS starter, monetization infrastructure for AI apps.
Best for: AI content tools, AI agent products, usage-based AI apps, credit-based SaaS products, indie AI products, internal AI tools that need production infrastructure, and teams adding monetization to an existing AI app.
Not for: teams looking for a no-code app builder, a hosted-only platform, or a finished vertical SaaS product. Harness gives you source code and production building blocks; you still build the product-specific workflow.
| If you are... | Start with... | What you get |
|---|---|---|
| An indie builder with an AI demo | Run Harness locally | Auth, billing, credits, payments, AI chat, admin, workers, analytics, and anti-abuse in one repo |
| A product team adding AI features | Read the framework guide | A production boundary for modules, services, events, queues, and third-party integrations |
Once prerequisites are ready, you can run the full local stack with one command:
pnpm install && (test -f .env || cp .env.example .env) && pnpm docker:db:up && pnpm db:push && pnpm db:seed && pnpm dev:all
Open http://localhost:3000 and you have a working AI SaaS foundation: sign-in, billing data, credits, background workers, admin surfaces, and a place to build your product module.
Harness gives you full control over your source code, infrastructure, and deployment.
Accept subscriptions and usage-based payments, manage credits, meter AI usage, and give customers a billing dashboard from day one.
Connect purchases to acquisition channels with server-side attribution, Google Ads offline conversions, X pixel events, and PostHog analytics.
Run an affiliate program with a double-entry ledger, refund clawbacks, referral tracking, promo codes, and USDT cashout.
Reduce free-credit abuse with rate limits, Turnstile, disposable-email checks, signup signals, guest quotas, and credit clawbacks.
Use built-in auth, multi-LLM chat, background workers, lifecycle email, admin tools, Docker, Kubernetes, and GitOps guidance.
| You are... | Harness helps you... |
|---|---|
| An indie developer with an AI prototype | Add monetization and production infrastructure without starting over |
| A team already serving AI users | Add usage billing, attribution, affiliates, and anti-abuse controls |
| An AI-native builder using Codex, Claude Code, or Cursor | Give coding agents a documented production foundation to build on |
| Option | Best when you need... | Tradeoff |
|---|---|---|
| Blank Next.js or T3 app | Full control with minimal starting code | You still build billing, credits, workers, admin, attribution, and anti-abuse |
| ShipFast-style SaaS starter | A fast generic SaaS launch path | Often optimized for standard subscriptions, not AI usage and credit cost |
| No-code or low-code builder | Fast non-technical prototyping | Less source-level control and harder custom backend behavior |
| Velobase Harness | Open-source AI SaaS infrastructure with code access | You still implement the product-specific AI workflow |
Prerequisites: Node.js, pnpm, Docker Desktop, and Docker Compose.
pnpm install
cp .env.example .env
pnpm docker:db:up
pnpm db:push
pnpm db:seed
pnpm dev:all
Open [http://localhost:3000]