explaingit

michaelshimeles/adam

Analysis updated 2026-05-18

51JavaScriptAudience · developerComplexity · 4/5Setup · hard

TLDR

Adam reimplements Vercel's eve AI agent runtime to run entirely inside a single Convex deployment, replacing its usual Postgres, Redis, and Node server setup.

Mindmap

mindmap
  root((adam))
    What it does
      Ports eve runtime to Convex
      Single deployment runtime
      Live dashboard
    Tech stack
      JavaScript
      Convex
      Svelte
      Node.js
    Use cases
      Run agent without separate server
      Watch live agent activity
      One click agent deploy
      Store app data with workflow state
    Repo layout
      backend package
      world-convex package
      agent package
      web dashboard

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run an AI agent built with Vercel's eve framework entirely on Convex instead of managing a separate Node server, Postgres, and Redis.

USE CASE 2

Watch an agent's runs, steps, and live model output update in real time through the included Svelte dashboard.

USE CASE 3

Deploy a new configured agent to its own Convex project directly from a dashboard, without manual server setup.

USE CASE 4

Build agent tools that write ordinary application data alongside the agent's workflow state in the same Convex tables.

What is it built with?

JavaScriptConvexSvelteNode.js

How does it compare?

michaelshimeles/adamgangweix/next-forcingwanduforl/macarkpet
Stars515151
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyhardhardeasy
Complexity4/55/52/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Node 24+, pnpm 10, a local Convex deployment, and manually setting several environment variables including model credentials.

No license information was found in the README.

In plain English

Adam takes Vercel's eve, a durable AI agent runtime that normally runs as a long running Node server backed by Postgres and Redis, and rebuilds it so that everything runs on Convex instead. This is not just moving where the data is stored, it moves the actual execution engine itself. The eve build tool is used like a compiler, and the resulting server bundle is loaded into a Convex deployment and run inside Convex actions, so at runtime there is no separate eve server running at all. One Convex deployment ends up holding everything the system needs: the agent runtime itself, the workflow state such as runs, steps, events, and hooks, a message queue with retries and backoff handled by Convex's own scheduler, live streaming output from the AI model that the dashboard can watch update in real time, cron based schedules translated from eve's markdown schedule files, ordinary application data like a demo notepad tool, and even the dashboard web app itself, which is a Svelte 5 interface served directly from Convex. The repository is organized into a few main pieces. The backend package holds the Convex deployment along with the vendored eve bundle. A separate package implements the storage, queue, and streaming interfaces that eve expects, built specifically for Convex. An agent package defines the actual AI agent, its tools, and its schedule, and gets compiled with the eve build tool rather than run as a live server. A web package holds the Svelte based dashboard for chatting with the agent and watching its activity. There is also a platform piece that lets someone configure a new agent through a dashboard and deploy it to its own Convex project with one click. Getting it running locally involves installing dependencies with pnpm, starting a local Convex development deployment, and setting a handful of environment variables such as a world service secret, an execution mode flag, the Convex URL, and credentials for whichever AI model the agent will call. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Explain how adam moves Vercel eve's entire execution engine, not just its state, onto Convex.
Prompt 2
Walk me through setting up adam locally with pnpm and a local Convex development deployment.
Prompt 3
How does adam's chat inline fast path make a warm conversation turn faster than waiting for a scheduled queue tick?
Prompt 4
Show me how the platform package in adam lets someone deploy a new agent to its own Convex project with one click.

Frequently asked questions

What is adam?

Adam reimplements Vercel's eve AI agent runtime to run entirely inside a single Convex deployment, replacing its usual Postgres, Redis, and Node server setup.

What language is adam written in?

Mainly JavaScript. The stack also includes JavaScript, Convex, Svelte.

What license does adam use?

No license information was found in the README.

How hard is adam to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is adam for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.