Embeddr

Your personal creative workspace — search, organize, and orchestrate artifacts, media, and AI workflows.

---

What is Embeddr?

Embeddr is a local-first, plugin-extensible workspace for managing your creative data. Think of it as a personal operating layer for artifacts — images, documents, code, workflows — with semantic search, a relation graph, AI tool integration, and a plugin system that lets you extend everything.

• Artifact-centric — everything is an artifact with typed metadata, relations, and lineage
• Plugin-extensible — add UI panels, backend routes, new capabilities, and AI tools
• AI-native — MCP server, LLM tool calling, Lotus agent integration
• Local-first — runs on your machine, your data stays yours

This repository is the Embeddr monorepo — the home for all official applications, libraries, and tooling.

Repository Layout

embeddr/
├── apps/
│   ├── cli/                # Embeddr CLI + API server (Python)
│   └── zen-ui/             # Zen Shell desktop UI (TypeScript / React)
├── packages/
│   ├── embeddr-core/       # Core artifact + plugin runtime (Python)
│   ├── client-ts/          # TypeScript API client
│   ├── react-ui/           # React component library
│   └── zen-shell/          # Windowing runtime, embeddable in any host UI
├── pnpm-workspace.yaml
├── pyproject.toml          # uv workspace declaration
└── package.json

Each app and package keeps its own README for usage, API docs, and per-package commands.

Development

This is a polyglot monorepo using pnpm workspaces for TypeScript and uv workspaces for Python. The two ecosystems live side by side — no Nx, no Bazel, just the native tooling for each language.

Prerequisites

• Node.js ≥ 20
• pnpm ≥ 9
• uv ≥ 0.5
• Python ≥ 3.12

Install

git clone https://github.com/embeddr-net/embeddr
cd embeddr

# TypeScript dependencies
pnpm install

# Python dependencies
uv sync

Run

# Backend + API server
uv run embeddr serve --reload --docs

# Frontend dev server (in a second terminal)
pnpm --filter @embeddr/zen-ui dev

Working on a single package

# TypeScript
pnpm --filter @embeddr/react-ui build
pnpm --filter @embeddr/zen-shell test

# Python
uv run --package embeddr-core pytest

Apps & Packages

Path	Name	Description
apps/cli	embeddr-cli	Embeddr CLI and API server — embeddr serve
apps/zen-ui	@embeddr/zen-ui	Desktop web UI built on Zen Shell
packages/embeddr-core	embeddr-core	Core runtime — artifacts, plugins, capabilities
packages/client-ts	@embeddr/client-typescript	Typed API client
packages/react-ui	@embeddr/react-ui	React component library
packages/zen-shell	@embeddr/zen-shell	Embeddable windowing runtime

Related Repositories

• embeddr-comfyui — ComfyUI nodepack with Embeddr integration
• lotus-cli — AI agent REPL for Embeddr workspaces
• plugin-examples — Example Embeddr plugins

Packages

License

Copyright 2026 Embeddr Labs and Contributors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this project except in compliance with the License. You may obtain a copy of the License at:

http://www.apache.org/licenses/LICENSE-2.0