# OpenSail ## Docs - [Authentication](https://docs.tesslate.com/authentication.md): JWT sessions, OAuth providers, email 2FA, external API keys, and desktop pairing for OpenSail - [API Endpoints](https://docs.tesslate.com/developer/api-reference.md): Complete reference of all backend REST API endpoints - [Container Orchestration](https://docs.tesslate.com/developer/container-orchestration.md): How Docker and Kubernetes manage user project containers - [Contributing Guide](https://docs.tesslate.com/developer/contributing.md): How to set up a development environment and contribute to OpenSail - [Data Flow Patterns](https://docs.tesslate.com/developer/data-flow.md): How requests flow through OpenSail from frontend to backend - [Database Models](https://docs.tesslate.com/developer/database-models.md): All 39+ SQLAlchemy models powering OpenSail - [Troubleshooting](https://docs.tesslate.com/developer/troubleshooting.md): Common issues and solutions for developers and self-hosters - [FAQ](https://docs.tesslate.com/faq.md): Common questions about OpenSail: licensing, pricing, models, data privacy, deployment, and usage - [Agents](https://docs.tesslate.com/guides/agents.md): The OpenSail agent runner is tesslate-agent, a 33-tool Python package that drives any LiteLLM-compatible model through a streaming iteration loop with progressive persistence and context compaction. - [API Keys](https://docs.tesslate.com/guides/api-keys.md): Two kinds of keys in OpenSail: external keys for invoking agents from outside, and BYOK provider keys for model routing. Both encrypted at rest. - [Architecture Panel](https://docs.tesslate.com/guides/architecture-panel.md): One canvas, one config file, two authors. The Architecture Panel is a React Flow graph that renders .tesslate/config.json. Humans and agents edit the same source of truth. - [AWS Production (EKS)](https://docs.tesslate.com/guides/aws-production.md): Deploy Tesslate OpenSail to AWS EKS with ECR, S3, IAM roles, NGINX Ingress, cert-manager, Cloudflare DNS, the btrfs CSI driver, and Volume Hub. - [Billing](https://docs.tesslate.com/guides/billing.md): Credits, subscription tiers, app billing dimensions, and creator payouts in OpenSail - [Chat Interface](https://docs.tesslate.com/guides/chat-interface.md): The chat panel is where you drive the agent: streaming output, inline tool calls, approval cards, agent and model selectors, file picker, attachments, and a full session history. - [Code Editor](https://docs.tesslate.com/guides/code-editor.md): Monaco-based code editor with multi-language syntax, autocomplete, find-in-files, refactor support, and a file tree that stays in sync with the agent. - [Communication Gateways](https://docs.tesslate.com/guides/communication-gateways.md): Put an OpenSail agent into Telegram, Slack, Discord, WhatsApp, Signal, or a CLI WebSocket, and run agents on cron schedules with delivery to any channel. - [Connectors and MCP](https://docs.tesslate.com/guides/connectors-mcp.md): Wire Slack, Gmail, Linear, GitHub, and dozens of other tools into any OpenSail agent using the Model Context Protocol - [Creating Projects](https://docs.tesslate.com/guides/creating-projects.md): Three paths to a new OpenSail project: pick a template, import a git repo, or describe what you want and let the agent scaffold it. - [Customizing Agents](https://docs.tesslate.com/guides/customizing-agents.md): Create a custom agent with a system prompt, bound skills, bound MCP connectors, a preferred model, and an approval policy - [Deployment Targets](https://docs.tesslate.com/guides/deployment-targets.md): Ship containers to 22 external providers from the Architecture Panel with a single edge connection, per-target environments, and independent rollback. - [Design Engineer](https://docs.tesslate.com/guides/design-engineer.md): Click any element in the live preview and jump to the exact line of source code that rendered it. Two-way sync between the preview, the editor, and the agent. CSS inspector, Insert palette, visual-first iteration. - [Docker Setup](https://docs.tesslate.com/guides/docker-setup.md): Run Tesslate OpenSail locally with Docker Compose. Fresh clone to a working project in under 20 minutes. - [Git Integration](https://docs.tesslate.com/guides/git-integration.md): GitHub, GitLab, and Bitbucket OAuth; clone, commit, push, branch from inside OpenSail. Every project is a real git repo, every agent can read and write git state. - [Kanban Board](https://docs.tesslate.com/guides/kanban-board.md): Track tasks, plan work, and let agents pick up tickets. Every card has a TSK-NNNN ref and lives inside your project. Agents can create, move, and comment as they work. - [Local Kubernetes (minikube)](https://docs.tesslate.com/guides/kubernetes-local.md): Run Tesslate OpenSail on a local Kubernetes cluster with the btrfs CSI driver, Volume Hub, NGINX Ingress, MinIO, Postgres, and Redis. - [Live Preview](https://docs.tesslate.com/guides/live-preview.md): Iframe preview with hot module reload per project. Preview nodes on the Architecture Panel, responsive breakpoints, and per-container URLs for multi-service apps. - [Marketplace](https://docs.tesslate.com/guides/marketplace.md): Browse and install agents, skills, MCP servers, bases, themes, and apps. One place for every reusable building block on OpenSail. - [Model Management](https://docs.tesslate.com/guides/model-management.md): Route AI requests through LiteLLM, bring your own keys, or self-host models with Ollama or vLLM. Switch providers without rewriting agents. - [Projects](https://docs.tesslate.com/guides/projects.md): A project is a working directory, a set of containers, a persistent volume, permissions, and a .tesslate/config.json graph. Everything you build on OpenSail lives inside one. - [Publishing Apps](https://docs.tesslate.com/guides/publishing-apps.md): Turn an OpenSail workspace into an installable Tesslate App: write a manifest, walk the four-stage approval pipeline, configure billing, and distribute via bundles or forks. - [Skills](https://docs.tesslate.com/guides/skills.md): Teach an agent a reusable capability once and let any agent use it forever. Progressive loading keeps the context window lean. - [Using Agents](https://docs.tesslate.com/guides/using-agents.md): Start a session, watch tools run, approve dangerous operations, and drive a tesslate-agent instance to get work done - [Workspaces](https://docs.tesslate.com/guides/workspaces.md): A workspace is the full, fork-able, snapshot-based environment that backs a project. Instant snapshots, 5-entry timeline, team-shareable, local-to-cloud portable. - [Welcome to OpenSail](https://docs.tesslate.com/introduction.md): Build agents, apps, and automations. Run them on your infrastructure. Share them across your team. - [Quickstart](https://docs.tesslate.com/quickstart.md): Sign in, create a project, and ship your first OpenSail agent in five minutes - [Architecture](https://docs.tesslate.com/self-hosting/architecture.md): How OpenSail is structured: orchestrator, agent runner, storage, three-tier compute, channels, and apps - [Configuration](https://docs.tesslate.com/self-hosting/configuration.md): Environment variable reference for OpenSail, grouped by subsystem, with defaults and examples - [Deployment](https://docs.tesslate.com/self-hosting/deployment.md): Overview of the three production paths for OpenSail: Docker Compose, Kubernetes on Minikube, and AWS EKS with Terraform - [Self-Hosting Quickstart](https://docs.tesslate.com/self-hosting/quickstart.md): Pick the right path to self-host OpenSail: Docker, Desktop, Kubernetes on Minikube, or AWS EKS ## OpenAPI Specs - [openapi](https://docs.tesslate.com/api-reference/openapi.json) ## Optional - [Community](https://discord.gg/qmrcHGNch7) - [GitHub](https://github.com/TesslateAI/opensail)