# Vellum Docs

> Vellum is a personal AI assistant that remembers, learns, and takes real action across your apps, files, and communication channels.

Vellum runs in Vellum Cloud by default, can run locally or on your own infrastructure, and ships as open-source software. These docs cover setup, memory, channels, skills, tools, hosting, security, and developer workflows.

Install: `curl -fsSL https://www.vellum.ai/install.sh | bash && . ~/.config/vellum/env`

Repo: https://github.com/vellum-ai/vellum-assistant

Docs: https://www.vellum.ai/docs

Full LLM index: https://www.vellum.ai/llms.txt

## Docs

- [Meet Vellum](https://www.vellum.ai/md/docs.md): Vellum documentation — guides, tutorials, and references for building your personal AI assistant.
- [Vellum Constitution](https://www.vellum.ai/md/docs/constitution.md): The Vellum Constitution — our purpose, worldview, principles, and the commitments that guide every product, design, and engineering decision we make.
- [Developer Guide](https://www.vellum.ai/md/docs/developer-guide.md): Technical reference for contributors and developers working on the Vellum Assistant platform.
- [API & Communication](https://www.vellum.ai/md/docs/developer-guide/api.md): SSE event stream, event payloads, connection management, and remote access via SSH.
- [Architecture](https://www.vellum.ai/md/docs/developer-guide/architecture.md): Platform domains, repository structure, and how the runtime, clients, and gateway fit together.
- [Contributing](https://www.vellum.ai/md/docs/developer-guide/contributing.md): How to set up the Vellum Assistant repo locally, run tests, follow code conventions, and submit a pull request.
- [Development Workflow](https://www.vellum.ai/md/docs/developer-guide/development-workflow.md): Claude Code slash commands, parallel PR execution, automated review loops, and the release pipeline.
- [Features & Capabilities](https://www.vellum.ai/md/docs/developer-guide/features.md): Integrations, dynamic skill authoring, browser automation, attachments, and media embeds.
- [Get Started](https://www.vellum.ai/md/docs/developer-guide/get-started.md): Developer on-ramp for Vellum Assistant: repo layout, local dev setup, CLI, HTTP API, and SSE event stream.
- [Security & Permissions](https://www.vellum.ai/md/docs/developer-guide/security.md): Sandbox model, credential storage, trust rules, and permission modes for the Vellum Assistant platform.
- [Environments](https://www.vellum.ai/md/docs/environments.md): Choose a deployment environment for Vellum: Vellum Cloud (recommended), local, or user-hosted (GCP/AWS/custom), with trade-offs for each.
- [Extensibility](https://www.vellum.ai/md/docs/extensibility.md): All of the ways your Assistant can build on themselves. Overview of the surfaces a plugin can bundle and how they compose.
- [Distribution](https://www.vellum.ai/md/docs/extensibility/distribution.md): How plugins ship: a curated marketplace catalog, installing by name from the CLI, installing directly from a GitHub URL (untrusted), the marketplace.json manifest, and why entries pin an immutable commit.
- [Hooks](https://www.vellum.ai/md/docs/extensibility/hooks.md): Lifecycle hooks let a plugin run code at fixed points during the Assistant's lifecycle.
- [Plugins](https://www.vellum.ai/md/docs/extensibility/plugins.md): How a plugin is laid out on disk, what its package.json manifest declares, and the single @vellumai/plugin-api package every surface imports from.
- [Skills](https://www.vellum.ai/md/docs/extensibility/skills.md): Skills let a plugin bundle instructions, assets, and scripts the Assistant loads on demand when a conversation matches what the skill is for.
- [Tools](https://www.vellum.ai/md/docs/extensibility/tools.md): Tools let a plugin add new actions the model can call, landing in the same catalog as the Assistant's built-in tools.
- [Getting Started](https://www.vellum.ai/md/docs/getting-started.md): Get started with Vellum — installation, key concepts, quick start guide, and your first skill tutorial.
- [Installation](https://www.vellum.ai/md/docs/getting-started/installation.md): Get started with Vellum: sign up for Vellum Cloud, install the desktop app on macOS, or self-host. System requirements, setup, and permissions.
- [Key Concepts - Vellum Docs (Moved)](https://www.vellum.ai/md/docs/getting-started/key-concepts.md): Core concepts for using Vellum — workspace, skills, memory, channels, and assistant identity explained.
- [Quick Start](https://www.vellum.ai/md/docs/getting-started/quick-start.md): Your first 2 minutes with Vellum — setup, meeting your assistant, and getting started.
- [What is Vellum?](https://www.vellum.ai/md/docs/getting-started/what-is-vellum.md): What is Vellum? A personal AI assistant with tools, memory, identity, and a private cloud workspace, different from ChatGPT or Claude.
- [Your First Skill](https://www.vellum.ai/md/docs/getting-started/your-first-skill.md): Use and create your first Vellum skill — discover built-in skills, install new ones, and build custom skills.
- [Glossary](https://www.vellum.ai/md/docs/glossary.md): Vellum glossary — shared definitions for assistant, guardian, personal intelligence, memory, skills, channels, gateway, and other key terms.
- [Help](https://www.vellum.ai/md/docs/help.md): Get help with Vellum — frequently asked questions, common issues, and support channels.
- [Common Issues](https://www.vellum.ai/md/docs/help/common-issues.md): Troubleshoot common Vellum issues — installation, permissions, skills, performance, and workspace problems.
- [FAQ](https://www.vellum.ai/md/docs/help/faq.md): Frequently asked questions about Vellum — product capabilities, privacy, data handling, and your assistant.
- [Getting Help](https://www.vellum.ai/md/docs/help/getting-help.md): How to get help with Vellum — community, GitHub issues, email support, and what information to include.
- [Hosting options](https://www.vellum.ai/md/docs/hosting-options.md): Choose where your assistant runs: Vellum Cloud (recommended), local on your Mac, or self-hosted on your own infrastructure.
- [Advanced options](https://www.vellum.ai/md/docs/hosting-options/advanced-options.md): Advanced hosting options for Vellum assistants: Local Apple Container, GCP, and AWS.
- [Cloud hosting](https://www.vellum.ai/md/docs/hosting-options/cloud-hosting.md): Run your assistant on Vellum Cloud: always-on, sandboxed per account, reachable from web, desktop, voice, and chat channels.
- [Local hosting](https://www.vellum.ai/md/docs/hosting-options/local-hosting.md): Run your assistant locally on your Mac with setup guidance, tradeoffs, and best practices.
- [Key Concepts](https://www.vellum.ai/md/docs/key-concepts.md): Core Vellum concepts — workspace, skills and tools, memory and context, channels, assistant identity, and glossary.
- [Channels](https://www.vellum.ai/md/docs/key-concepts/channels.md): Vellum communication channels — desktop app, CLI, Telegram, Slack, email, and phone. Same assistant everywhere, adapted to each channel.
- [Memory & Context](https://www.vellum.ai/md/docs/key-concepts/memory-and-context.md): How Vellum remembers — workspace files, long-term memory, context assembly, and privacy considerations.
- [Model Profiles](https://www.vellum.ai/md/docs/key-concepts/model-profiles.md): Control which LLM model and settings your assistant uses for each job — conversations, memory, background tasks — and optimize token costs with profiles and call-site overrides.
- [OAuth Integrations](https://www.vellum.ai/md/docs/key-concepts/oauth-integrations.md): How Vellum connects to third-party services via OAuth2: supported services, how the credential vault works, security model, and troubleshooting.
- [Scheduling](https://www.vellum.ai/md/docs/key-concepts/scheduling.md): How scheduling and automation work in Vellum — one-shot and recurring schedules, heartbeats, watchers, playbooks, and proactive background work.
- [Tools & Skills](https://www.vellum.ai/md/docs/key-concepts/skills-and-tools.md): Skills vs. tools in Vellum — atomic actions, capability bundles, built-in skills, and creating custom skills.
- [The Workspace](https://www.vellum.ai/md/docs/key-concepts/the-workspace.md): The Vellum workspace — folder structure, IDENTITY.md, SOUL.md, USER.md, LOOKS.md, config.json, and skills directory.
- [Web Search](https://www.vellum.ai/md/docs/key-concepts/web-search.md): How web search works in Vellum: managed vs bring your own, the four built-in providers (Provider Native, Perplexity, Brave, Tavily), the fallback chain, and how it's billed.
- [Brave Search](https://www.vellum.ai/md/docs/key-concepts/web-search/brave.md): How to connect Brave Search as your web search provider in Vellum: API key setup, provider configuration, and usage.
- [Firecrawl](https://www.vellum.ai/md/docs/key-concepts/web-search/firecrawl.md): How to connect Firecrawl as your web search and web fetch provider in Vellum: API key setup, provider configuration, and usage.
- [Perplexity](https://www.vellum.ai/md/docs/key-concepts/web-search/perplexity.md): How to connect Perplexity as your web search provider in Vellum: API key setup, provider configuration, and usage.
- [Tavily](https://www.vellum.ai/md/docs/key-concepts/web-search/tavily.md): How to connect Tavily as your web search provider in Vellum: API key setup, provider configuration, and usage.
- [Pricing](https://www.vellum.ai/md/docs/pricing.md): How Vellum pricing works today: prepaid credits, pending usage, and how to add credits to your account.
- [Privacy Notice](https://www.vellum.ai/md/docs/privacy-policy.md): Vellum's privacy notice explaining how we collect, use, disclose and otherwise process your information.
- [Vellum Prohibited Use Policy](https://www.vellum.ai/md/docs/prohibited-use.md): Vellum's prohibited use policy — ensuring the Services are used safely, ethically, and in accordance with all applicable laws and regulations.
- [Releases - Vellum Docs](https://www.vellum.ai/md/docs/releases.md): Vellum release notes, versioning, update channels, and how to stay up to date with the latest features and fixes.
- [Roadmap](https://www.vellum.ai/md/docs/roadmap.md): What's coming to Vellum — shipping soon, up next, on the horizon, and what we're exploring.
- [Skills Reference](https://www.vellum.ai/md/docs/skills-reference.md): Vellum skills reference — documentation for all available skills, capabilities, and configuration options.
- [ACP](https://www.vellum.ai/md/docs/skills-reference/acp.md): ACP skill for Vellum — delegates development tasks through the Agent Client Protocol.
- [Amazon](https://www.vellum.ai/md/docs/skills-reference/amazon.md): Amazon skill for Vellum — shop, track orders, and manage your Amazon account through your assistant.
- [App Builder](https://www.vellum.ai/md/docs/skills-reference/app-builder.md): App Builder skill for Vellum — create interactive web apps with HTML, CSS, and JavaScript through conversation.
- [Browser](https://www.vellum.ai/md/docs/skills-reference/browser.md): Browser skill for Vellum — navigate web pages, interact with content, and extract information.
- [ChatGPT Import](https://www.vellum.ai/md/docs/skills-reference/chatgpt-import.md): ChatGPT Import skill for Vellum — imports your conversation history from ChatGPT into Vellum.
- [Computer Use](https://www.vellum.ai/md/docs/skills-reference/computer-use.md): Computer Use skill for Vellum — control your Mac directly with screen observation, clicking, typing, and AppleScript.
- [Contacts](https://www.vellum.ai/md/docs/skills-reference/contacts.md): Contacts skill for Vellum — manage contacts, communication channels, access control, and invite links.
- [Document](https://www.vellum.ai/md/docs/skills-reference/document.md): Document skill for Vellum — create and edit long-form text in a dedicated rich-text editor with Markdown support.
- [DoorDash](https://www.vellum.ai/md/docs/skills-reference/doordash.md): DoorDash skill for Vellum — order food, groceries, and convenience items through your assistant.
- [Email (AgentMail)](https://www.vellum.ai/md/docs/skills-reference/email-agentmail.md): Email skill for Vellum — send, read, search, and manage email from your assistant's own address.
- [Followups](https://www.vellum.ai/md/docs/skills-reference/followups.md): Followups skill for Vellum — tracks messages awaiting responses across all communication channels.
- [Gmail](https://www.vellum.ai/md/docs/skills-reference/gmail.md): Gmail skill for Vellum — full inbox management including archive, label, draft, send, and filter capabilities.
- [Google Calendar](https://www.vellum.ai/md/docs/skills-reference/google-calendar.md): Google Calendar skill for Vellum — view events, create meetings, and check availability.
- [Image Studio](https://www.vellum.ai/md/docs/skills-reference/image-studio.md): Image Studio skill for Vellum — generate and edit images using AI through your assistant.
- [Media Processing](https://www.vellum.ai/md/docs/skills-reference/media-processing.md): Media Processing skill for Vellum — processes video, audio, and image files through a multi-phase AI pipeline.
- [Messaging](https://www.vellum.ai/md/docs/skills-reference/messaging.md): Messaging skill for Vellum — send and receive messages across Slack, Gmail, and Telegram.
- [Notifications](https://www.vellum.ai/md/docs/skills-reference/notifications.md): Notifications skill for Vellum — sends notifications through a unified routing system across connected channels.
- [Phone Calls](https://www.vellum.ai/md/docs/skills-reference/phone-calls.md): Phone Calls skill for Vellum — make and receive calls via Twilio with real-time voice conversation and transcription.
- [Playbooks](https://www.vellum.ai/md/docs/skills-reference/playbooks.md): Playbooks skill for Vellum — trigger-action automation rules for handling incoming messages.
- [Schedule](https://www.vellum.ai/md/docs/skills-reference/schedule.md): Schedule skill for Vellum — recurring and one-shot scheduled actions using cron syntax, RRULE patterns, or simple timestamps.
- [Screen Watch](https://www.vellum.ai/md/docs/skills-reference/screen-watch.md): Screen Watch skill for Vellum — observe your screen at regular intervals with OCR for context-aware assistance.
- [Skill Management](https://www.vellum.ai/md/docs/skills-reference/skill-management.md): Skill Management skill for Vellum — creates and deletes custom managed skills to extend your assistant.
- [Slack](https://www.vellum.ai/md/docs/skills-reference/slack.md): Slack skill for Vellum — scan channels, summarize threads, manage reactions, and configure privacy-aware integration.
- [Start the Day](https://www.vellum.ai/md/docs/skills-reference/start-the-day.md): Start the Day skill for Vellum — get a personalized daily briefing with weather, news, and tasks.
- [Subagent](https://www.vellum.ai/md/docs/skills-reference/subagent.md): Subagent skill for Vellum — spawns autonomous background agents that work independently on tasks.
- [Tasks](https://www.vellum.ai/md/docs/skills-reference/tasks.md): Tasks skill for Vellum — a two-layer task system with reusable templates and a prioritized work queue.
- [Transcribe](https://www.vellum.ai/md/docs/skills-reference/transcribe.md): Transcribe skill for Vellum — transcribes audio and video files using OpenAI Whisper or whisper.cpp.
- [Watcher](https://www.vellum.ai/md/docs/skills-reference/watcher.md): Watcher skill for Vellum — polls external services for changes and notifies you when something happens.
- [Weather](https://www.vellum.ai/md/docs/skills-reference/weather.md): Weather skill for Vellum — get current conditions and forecasts for any location.
- [Trust & Security](https://www.vellum.ai/md/docs/trust-security.md): Vellum trust and security — privacy, data handling, permissions, and deployment best practices.
- [Privacy & Data](https://www.vellum.ai/md/docs/trust-security/privacy-and-data.md): Vellum privacy and data — what stays local, what leaves your device, and what Vellum never does.
- [Security Best Practices](https://www.vellum.ai/md/docs/trust-security/security-best-practices.md): Security best practices for Vellum — sharing information, reviewing files, permissions, and credentials.
- [The Permissions Model](https://www.vellum.ai/md/docs/trust-security/the-permissions-model.md): Vellum's permissions model — risk tolerance tiers, sandbox boundary, trust rules, and the Allow/Deny permission prompt.
- [Vellum Terms of Service](https://www.vellum.ai/md/docs/vellum-terms-of-use.md): Vellum's terms of service — the agreement governing your use of the Vellum AI agent platform and services.