# vercel/eve

The Open Framework for Building Agents

Repository: https://github.com/vercel/eve
Canonical: https://ross.abutalabs.com/products/vercel-eve
Homepage: https://eve.dev
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: agent, framework, harness, javascript, markdown, typescript, vercel, sandbox, workflows
Last push: 2026-08-26T23:20:02+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 5
- inputs: {"age_days": 78, "days_push": 7, "days_rel": 7, "gap_med": 0, "n_releases_24m": 148}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4820, forks 483 (observed 2026-08-28T04:09:00.334267+00:00)

## What it is
eve is a filesystem-first TypeScript framework by Vercel for building durable AI agents, where an agent is defined by a conventional directory layout (instructions.md, tools/, skills/, channels/, schedules/). It includes a CLI for scaffolding, a dev server with terminal UI, sandboxing, and integrations for Slack, Discord, Telegram, and other messaging channels.

## Use cases
- build an AI agent from a markdown instructions file
- create a Slack or Discord chatbot backed by an LLM
- schedule recurring agent tasks with cron
- add typed tools an LLM can call from TypeScript files
- scaffold a durable agent project with npx
- run an agent across multiple messaging channels
- give agents on-demand skills via markdown playbooks

## When to choose
- you want a convention-over-configuration agent framework in TypeScript
- you prefer authoring agent behavior in markdown and filesystem conventions
- you need durable agents with channels, schedules, and sandboxes out of the box
- you're in the Vercel/AI SDK ecosystem and want AI Gateway integration

## When to avoid
- you need a Python agent framework
- you want full programmatic control over agent orchestration rather than filesystem conventions
- you need a very lightweight library without CLI scaffolding
- your runtime can't run Node.js 24+ or newer

## Facets
- artifact type: framework
- maturity: active
- function: agent-framework, workflow-automation, chatbot, scheduling, webhook, cli, developer-tools
- domain: large-language-models, developer-tools, backend
- platform: cli, cross-platform
- tags: filesystem-first, durable-agents, ai-gateway, skills, channels, sandbox, vercel, markdown-instructions, tools, ai-agents, automation, nodejs, typescript

## Member repositories
- vercel/eve (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:00.334267+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:18:32.688217+00:00, confidence not recorded.
  - readme: https://github.com/vercel/eve (fetched 2026-08-28T04:09:00.334267+00:00, sha ad0254a532b6)
  - homepage: https://eve.dev (fetched 2026-08-29T09:01:44.616159+00:00, sha 61d7273de563)
  - site_page: https://eve.dev/docs/getting-started (fetched 2026-08-29T09:01:44.623457+00:00, sha 4a62977ce60d)
  - site_page: https://eve.dev/docs (fetched 2026-08-29T09:01:44.619021+00:00, sha 038e1419eaf2)
  - site_page: https://eve.dev/integrations (fetched 2026-08-29T09:01:44.621177+00:00, sha c9f66e0095c3)
- Data as of 2026-08-30T08:39:29.467469+00:00.