# Varin

> An open-source AI agent harness for coding, research and office work. Bring your own API key, coordinate agents and customize tools. Windows, macOS and Linux.

This is the Varin product website. The localized Markdown overviews are generated from the same copy as the HTML homepages. Each overview identifies its canonical HTML URL and links to source sections. The user guides are HTML pages rendered from the Markdown sources in the product repository. Release assets and technical instructions are maintained in the linked repository.

Desktop downloads cover Windows, macOS and Linux. Docker self-hosting is documented separately. Varin uses your own API keys; the source code is licensed under AGPL-3.0-only.

## Product overviews

- [English](https://varin.dev/index.md): Product overview in English.
- [简体中文](https://varin.dev/zh-cn/index.md): Product overview in 简体中文.
- [繁體中文](https://varin.dev/zh-tw/index.md): Product overview in 繁體中文.
- [Français](https://varin.dev/fr/index.md): Product overview in Français.
- [日本語](https://varin.dev/ja/index.md): Product overview in 日本語.

## Documentation

- [User guides](https://varin.dev/docs/): User guides in English.
- [使用文档](https://varin.dev/zh-cn/docs/): User guides in 简体中文.
- [使用文件](https://varin.dev/zh-tw/docs/): User guides in 繁體中文.
- [Guides](https://varin.dev/fr/docs/): User guides in Français.
- [使い方ガイド](https://varin.dev/ja/docs/): User guides in 日本語.
- [Guide sources](https://github.com/Youzini-afk/Varin/tree/main/packages/docs): Markdown/MDX sources of the user guides in every language.
- [Docker deployment](https://raw.githubusercontent.com/Youzini-afk/Varin/main/docs/ops/cloud-deployment.md): Self-hosting instructions.
- [Extension authoring](https://raw.githubusercontent.com/Youzini-afk/Varin/main/docs/ops/varin-extension-authoring.md): Extension contracts, SDK and CLI.

## User guides

### Start here

- [Varin user guides](https://varin.dev/docs/): Connect a model, start a conversation, and work with files and tools.
- [Install](https://varin.dev/docs/install/): Install the Varin desktop app, self-host it with Docker, or build it from source.
- [Quickstart](https://varin.dev/docs/quickstart/): Start Varin quickly and pick the right app for the task.
- [Environment Variables](https://varin.dev/docs/environment/): Configure the Varin server, terminals, Git, voice, and tunnels with environment variables.

### Workflows

- [Projects](https://varin.dev/docs/projects/): Organize your work into projects and switch between them.
- [Context](https://varin.dev/docs/context/): Inspect native context checkpoints and retained history.
- [Images and PDFs](https://varin.dev/docs/attachments/): Attach images and retain original PDFs in a conversation.
- [Project Notes, Todos & Plans](https://varin.dev/docs/notes-todos-plans/): Keep notes, a todo list, and saved plans for each project.
- [Scheduled tasks and follow-ups](https://varin.dev/docs/scheduled-tasks/): Schedule native calendar work or continue a conversation on a condition.
- [Agent tools](https://varin.dev/docs/agent-control-tool/): Understand the native tools used to coordinate work.
- [Continuing goals](https://varin.dev/docs/session-goals/): Authorize native work to continue toward an explicit objective.
- [Project Actions](https://varin.dev/docs/project-actions/): Save commands you run often and launch them in one click.
- [Worktree Sessions](https://varin.dev/docs/worktrees/): Give a session its own branch and folder so work stays isolated.
- [Multi-run](https://varin.dev/docs/multi-run/): Run the same prompt across several models or sessions at once.
- [Git & GitHub Workflows](https://varin.dev/docs/git/): Stage, commit, and manage branches without leaving Varin.
- [GitHub Issues & PRs](https://varin.dev/docs/github/): Connect GitHub to manage pull requests from Varin.
- [Agent memory and instructions](https://varin.dev/docs/agent-personalization/): Manage scoped notes and system instructions for ordinary Agents.
- [Git Identities](https://varin.dev/docs/git-identities/): Commit as the right name and email for each repository.

### Agent setup

- [Model channels](https://varin.dev/docs/providers/): Connect model accounts and choose models for native conversations.
- [MCP Servers](https://varin.dev/docs/mcp/): Add MCP servers to give agents extra tools.
- [Skills](https://varin.dev/docs/skills/): Create and use versioned instruction resources.
- [Skills library](https://varin.dev/docs/skills-catalog/): Manage native skill files and already installed resources.
- [Commands](https://varin.dev/docs/commands/): Invoke skills captured in the conversation context.
- [Branch token usage](https://varin.dev/docs/usage/): Inspect original model receipts for the selected branch.

### Remote access

- [Connect a Device](https://varin.dev/docs/connect-devices/): Pair your phone, desktop, or another browser with your Varin server using a one-time QR code.
- [Private Relay](https://varin.dev/docs/private-relay/): Connect paired devices through an available end-to-end encrypted relay.
- [Tunnels](https://varin.dev/docs/tunnels/): Expose Varin safely for remote and mobile access.
- [Reverse Proxy](https://varin.dev/docs/reverse-proxy/): Configure Varin correctly behind Nginx, Nginx Proxy Manager, or another reverse proxy.
- [Mobile Apps & PWA](https://varin.dev/docs/mobile/): Install the Varin app on iOS or Android and connect it to your server.
- [Security](https://varin.dev/docs/security/): Protect the UI with a password and passkeys before exposing it.

### Customize

- [Themes](https://varin.dev/docs/themes/): Customize Varin with built-in and user-defined themes.
- [Notifications](https://varin.dev/docs/notifications/): Get told when a session needs you or finishes.
- [Voice Mode](https://varin.dev/docs/voice/): Speak to Varin and hear replies read aloud.
- [Project Icons](https://varin.dev/docs/project-icons/): Give each project a recognizable icon.

### Desktop

- [Remote Instances](https://varin.dev/docs/remote-instances/): Connect the desktop app to Varin on another machine over SSH.
- [Desktop Browser](https://varin.dev/docs/desktop-browser/): Browse any page inside the desktop app, with inspect and console capture.
- [Desktop Tunnels](https://varin.dev/docs/desktop-tunnels/): Create Cloudflare or Ngrok tunnels from the desktop app.
- [SSH Hosts & Proxying](https://varin.dev/docs/ssh-hosts-proxying/): Import saved SSH hosts and add extra SSH port forwards in the desktop app.
- [Updates](https://varin.dev/docs/updates/): Keep Varin up to date on desktop and web.

### Help

- [Troubleshooting](https://varin.dev/docs/troubleshooting/): Common setup and runtime issues with quick fixes.
- [Worktrees & Git](https://varin.dev/docs/troubleshooting/worktrees-git/): Fix common worktree and git problems.
- [Remote Access](https://varin.dev/docs/troubleshooting/remote-access/): Fix tunnels, remote instances, and reaching Varin from another device.

## Project

- [Source repository](https://github.com/Youzini-afk/Varin): Source code and README.
- [Latest release](https://github.com/Youzini-afk/Varin/releases/latest): Current version, platform support and download assets.
- [Changelog](https://raw.githubusercontent.com/Youzini-afk/Varin/main/CHANGELOG.md): Version history.
- [License](https://raw.githubusercontent.com/Youzini-afk/Varin/main/LICENSE): AGPL-3.0-only license text.

## Optional

- [Full English text](https://varin.dev/llms-full.txt): The product overview and every English user guide in a single plain-text response.
- [Extension examples](https://github.com/Youzini-afk/Varin/tree/main/examples/extensions): Example extension source tree.
- [Issue tracker](https://github.com/Youzini-afk/Varin/issues): Bug reports and feature requests.
- [Sitemap](https://varin.dev/sitemap.xml): Canonical HTML pages and their language alternates.