Waleed
011f26d9f3
* refactor: remove dead code, orphan modules, and two unused dependencies Every symbol below was classified per reference hit as: own declaration / barrel re-export line / vi.mock stub / real production caller. Only symbols with zero real callers are removed. Orphan modules (nothing imports them): - scheduled-tasks/components/schedule-calendar/ — 11 files. Zero references repo-wide, not even a barrel line. - terminal/components/filter-popover/ — re-exported through a barrel, consumed by nothing. - 6 iso-marks primitives (IsoCubeGrid, IsoCubeRow, IsoFourBox, IsoGridPlane, IsoStackedPlanes, IsoStar). mothership.tsx imports only the four Iso*Illustrations, which do not use these. - 4 copilot user-input hooks (useMentionKeyboard, useTextareaAutoResize, useMentionInsertHandlers, useCaretViewport) — barrel line only. Their six siblings in that directory are live and stay. - lib/workflows/application/duplicate-workflow.ts — an orphaned authorized use case. Live duplication goes through lib/workflows/persistence/duplicate.ts, which exports a same-named duplicateWorkflow; the 23 apparent references are all to that one. Nothing imports the application path. Dead exports: - lib/compare/data/feature-catalog.ts (SIM_FEATURES, 939 lines) plus the SimFeature type, FeatureCategory union, and featuresByCategory/featuresByTag helpers that only it used — one unshipped feature-comparison catalog. - createExecutionCallbacks (execution-events.ts) — declaration only, zero other hits repo-wide. Stale vi.mock targets — mocks whose module no longer exists, so they are silent no-ops that make a test look protected when it is not: - @/background/logs-webhook-delivery and @/app/api/webhooks/utils in the webhook trigger route test (its generateRequestHashMock and validateSlackSignatureMock hoisted vars went with it) - @/lib/workflows/subblocks/options in blocks/blocks/logs.test.ts - @/lib/uploads/setup in the S3 client test - @/lib/uploads/setup.server in the files delete and parse route tests — parse/route.test.ts mocks the real @/lib/uploads/core/setup.server on the very next line Dependencies: three and @types/three. Zero imports anywhere, and absent from every config, script, workflow, Dockerfile and chart. Both arrived with the speech-to-speech voice mode, which has since been removed. Deliberately kept: build-chat-animation/ reads as an orphan but build-callout.tsx documents it as parked unwired for reuse. * chore: update lockfile for the three/@types/three removal CI runs bun install --frozen-lockfile, so dropping the two dependencies from apps/sim/package.json without regenerating bun.lock fails the install step. The diff is the two entries plus three's transitives (@dimforge/rapier3d-compat, @tweenjs/tween.js, @types/stats.js, @types/webxr, @webgpu/types, meshoptimizer). One change deserves a note: top-level fflate moves 0.8.3 -> 0.4.8. It was hoisted to 0.8.3 only because @types/three required ~0.8.2; with that gone the remaining top-level consumer is posthog-js, which asks for ^0.4.8. Every other consumer keeps its own pinned nested entry (@shuding/opentype.js 0.7.4, @smithy/middleware-compression 0.8.1), and no source file imports fflate directly, so no resolution changes for anything that was already installed.
A workspace to build, deploy and manage AI agents and workflows.
Quickstart
Cloud-hosted: sim.ai
Self-hosted
npx sim-setup
Capabilities
- Connect 1,000+ integrations and every major LLM
- Add Slack, Notion, HubSpot, Salesforce, databases, and more
- Build agents visually, conversationally, or with code
- Ingest files, knowledge bases, and structured table data
- Monitor runs, logs, schedules, and workflow activity
One workspace, every surface
Chat and workflows are just the start — tables, files, and knowledge all live in the same workspace.
Tables — a database, built in |
Files — one store for your team and every agent |
Knowledge — your agents' memory |
Self-hosting
Requirements: Node.js 20+ and Docker.
npx sim-setup is an interactive wizard that creates a small sim/ deployment directory, provisions the database, generates secrets, writes .env, connects a Chat API key, and starts the published Sim images with Docker Compose. It does not clone the repository.
When it finishes, open http://localhost:3000.
Inside a cloned Sim repository, run bun run sim-setup to unlock the source-only local development and Kubernetes modes.
Reconfigure an optional capability without rerunning the full wizard:
npx sim-setup config
npx sim-setup add email
npx sim-setup add storage
npx sim-setup add sandbox
npx sim-setup add jobs
npx sim-setup add cache
npx sim-setup add knowledge
npx sim-setup add chat
npx sim-setup add llm
npx sim-setup add integration slack
npx sim-setup config detects the effective local-dev, Docker Compose, or current-context
Helm configuration and reports configured, missing, or invalid capabilities and OAuth
integrations without printing credential values. This is separate from npx sim-setup status,
which reports whether installed services are running and healthy.
Manage your install from its directory:
npx sim-setup start | stop | restart # bring your install up / down / cycle
npx sim-setup update # pull and apply Compose images
npx sim-setup status # what's installed and healthy
npx sim-setup logs # follow logs
npx sim-setup doctor # diagnose configuration problems
npx sim-setup down # remove containers (data kept)
npx sim-setup reset # archive .env and wipe managed data
The setup package detects how you're running and acts accordingly. Use --dir <path> to create or manage a deployment somewhere other than ./sim.
Sim also supports local models via Ollama and vLLM. See the self-hosting docs for details.
Chat API Keys
Chat is a Sim-managed service. npx sim-setup connects a Chat API key for you — sign in when it opens your browser and the key is stored automatically. To view, create, or revoke keys later, go to sim.ai/selfhost/settings/chat-keys.
Environment Variables
See the environment variables reference for the full list, or apps/sim/.env.example for defaults.
Tech Stack
Next.js · Bun · PostgreSQL · Drizzle · Better Auth · Tailwind — and the rest of the stack
- Framework: Next.js (App Router)
- Runtime: Bun
- Database: PostgreSQL with Drizzle ORM
- Authentication: Better Auth
- Schema Validation: Zod
- UI: Shadcn, Tailwind CSS
- Streaming Markdown: Streamdown
- State Management: Zustand, TanStack Query
- Flow Editor: ReactFlow
- Docs: Fumadocs
- Monorepo: Turborepo
- Realtime: Socket.io
- Background Jobs: Trigger.dev
- Remote Code Execution: E2B
- Isolated Code Execution: isolated-vm
Contributing
We welcome contributions! Please see our Contributing Guide for details.
License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
