Installation
Package name vs project name: The npm package is published as
@blyp/core. The project, CLI, and all tooling use the name Blyp. The CLI is@blyp/cliwith theblypcommand.
Package managers
Install the npm package @blyp/core. The source repository remains Blyphq/blyp.
# Bun (recommended)
bun add @blyp/core
# npm
npm install @blyp/core
# pnpm
pnpm add @blyp/core
# yarn
yarn add @blyp/coreRuntime and language requirements
- Bun
1.2+or Node.js18+ - TypeScript
5+
Optional framework peers
Blyp ships one package, but framework adapters rely on the framework you already use:
| Adapter | Import path | Optional peer |
|---|---|---|
| Elysia | @blyp/core/elysia | elysia |
| Expo | @blyp/core/expo | expo-network in your Expo app |
| Hono | @blyp/core/hono | hono |
| Express | @blyp/core/express | express |
| Fastify | @blyp/core/fastify | fastify |
| NestJS | @blyp/core/nestjs | @nestjs/*, rxjs |
| Next.js App Router | @blyp/core/nextjs | next |
| TanStack Start | @blyp/core/tanstack-start | @tanstack/react-start |
| SvelteKit | @blyp/core/sveltekit | @sveltejs/kit |
| Cloudflare Workers | @blyp/core/workers | none |
| Database adapters | @blyp/core/database | @prisma/client or drizzle-orm |
Published subpaths
These are the package exports covered by the current docs:
@blyp/core@blyp/core/standalone@blyp/core/client@blyp/core/database@blyp/core/betterstack@blyp/core/posthog@blyp/core/sentry@blyp/core/otlp@blyp/core/elysia@blyp/core/expo@blyp/core/hono@blyp/core/express@blyp/core/fastify@blyp/core/nestjs@blyp/core/nextjs@blyp/core/tanstack-start@blyp/core/sveltekit@blyp/core/workers
CLI
Blyp now also has a separate CLI repository. The CLI package is @blyp/cli, and the executable command is blyp.
- GitHub: Blyphq/cli
- npm:
@blyp/cli
The CLI README currently documents these commands:
blyp studio [targetPath]blyp healthblyp skills install [source-or-skill-name] [--force]blyp db:initblyp db:migrateblyp db:generateblyp helpblyp --version
Bootstrapped local config
When Blyp runs inside an application project, it bootstraps a blyp.config.json file and adds logs to .gitignore if they do not already exist. Blyp can also load blyp.config.ts, blyp.config.mts, blyp.config.cts, blyp.config.js, blyp.config.mjs, and blyp.config.cjs. See Configuration before relying on the defaults in production.
Expo-specific install
If you are using the Expo integration, install the Expo network module in your app:
npx expo install expo-networkLocal development
git clone https://github.com/Blyphq/blyp.git
cd blyp
bun install
bun run test
bun run build
bun run type-check