A toolkit for building production AI agents entirely on Upstash Redis. It gives you the stateful primitives agents need — memory, conversation history, search, and caching — plus thin adapters for the popular agent frameworks. The "semantic" features are powered by Upstash Redis Search and its $smart fuzzy operator, so no separate vector database is required.

• Chat history — durable, Redis-Search-backed conversation transcripts (ChatHistory): save the whole message array per chat, list a user's chats for a sidebar, and fuzzily $smart-search what the user or model said.
• Agent memory — long-term, fuzzily-recalled memories scoped per agent/user, plus drop-in recall/save tools for generateText.
• Search tools — schema-driven search/aggregate/count tools over Upstash Redis Search; the index is created reactively on first use. Use these over your own documents for RAG-style retrieval.
• Rate limiting — a configured Upstash Ratelimit factory (createRateLimit) you call before the model.
• Code sandbox (Eve only) — a drop-in Upstash Box backend for Eve's defineSandbox.
• Tool-call cache — memoize deterministic tool results keyed by arguments.

Runnable demos (real Upstash Redis + a mock/real model) live in examples/: ai-sdk-demo, eve-demo, and eve-extension-demo (an eve agent that mounts @upstash/agentkit-eve-extension).

pnpm install
pnpm build      # build all packages
pnpm test       # run all tests (against a real Upstash Redis; LLM calls mocked unless OPENAI_API_KEY is set)
pnpm lint       # eslint + prettier
pnpm typecheck  # tsc across packages

Tests need UPSTASH_REDIS_REST_URL / UPSTASH_REDIS_REST_TOKEN (in a repo-root .env); suites that hit Redis skip themselves when absent. Some tests use UPSTASH_BOX_API_KEY and OPENAI_API_KEY.

This repo uses Changesets.

pnpm changeset        # describe a change
pnpm ci:version       # bump versions + changelogs
pnpm ci:publish       # publish to npm

# (`version`/`release` script names are avoided — they collide with pnpm's built-in commands.)

MIT