Pulse

The AI Runtime.

Build production AI systems, not prompt chains.

import { runtime, agent } from "@pulse/runtime";
import { openai } from "@pulse/openai";

const app = runtime();

const assistant = agent({
  model: openai("gpt-5"),
  tools: [search, weather],
});

const result = await app.run(assistant, { message: "Plan my trip to Tokyo" });
console.log(result.text);

If you can read that in ten seconds, you already know Pulse.

React  = UI Runtime
Node   = Server Runtime
Docker = Container Runtime
Pulse  = AI Runtime

Not another agent framework — the runtime every agent framework wishes it had.

Start here

Path
Get a free API key → /dashboard/keys	Dashboard for local keys
Docs	Example-first guides
Manifesto	Why Pulse exists
Contributing	How to help
Good first issues	Entry points

pnpm install
pnpm dev          # website + docs → http://localhost:3000

Open /dashboard/keys for a free API key, then /docs to build.

Why open source from day one

Trust is everything in developer tooling. People hesitate to build production systems on closed infrastructure — especially in the AI ecosystem.

We build the community before the company. Code, docs, RFCs, and roadmap are public.

Status

Early. Website + docs + dashboard first. Runtime packages land phase by phase — see ROADMAP.md.

License	MIT
Code of Conduct	CODE_OF_CONDUCT.md
Security	SECURITY.md
Governance	GOVERNANCE.md
Architecture	ARCHITECTURE.md
RFCs	rfcs/
ADRs	docs/adr/

npm scope note: if @pulse is unavailable at publish time, the scope becomes @pulsejs — the design does not change.

Repository layout

.github/          CI, issue/PR templates, CODEOWNERS
docs/adr/         Architecture Decision Records
rfcs/             Public API proposals
packages/         @pulse/* runtime packages
website/          Landing, docs, dashboard
examples/         Runnable examples

No clutter. Everything has a purpose.

Develop

pnpm install
pnpm build:packages
pnpm test
pnpm typecheck
pnpm lint
pnpm dev          # http://localhost:3000

Every PR must pass CI: lint · typecheck · test · build.

Packages

Package	Role
@pulse/core	Shared primitives
@pulse/runtime	Execution engine
@pulse/events	Event bus
@pulse/workflow	sequence, parallel, retry, …
@pulse/tool	Typed tools
@pulse/model	Model interfaces
@pulse/agent	agent() / team()
@pulse/memory	Memory interfaces
@pulse/rag	knowledge()
@pulse/plugin	Plugin contract

Providers (@pulse/openai, …) ship separately and load via runtime.use(...).

Contributing

Read CONTRIBUTING.md and GOVERNANCE.md.

Before opening a PR:

Did this make the framework simpler?

• Major APIs need an RFC
• Design choices live in ADRs
• Questions → Discussions
• Bugs / tasks → Issues

Security

See SECURITY.md. Do not open public issues for vulnerabilities.

License

MIT © codeforstartups