git404hub

what is adam fr?

michaelshimeles/adam — explained in plain English

Analysis updated 2026-05-18

51JavaScriptAudience · developerComplexity · 4/5Setup · hard

tl;dr

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.

vibe map

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

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

what's the stack?

JavaScriptConvexSvelteNode.js

how it stacks up fr

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 i run it?

Difficulty · hard time til it works · 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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.