# TulipFarm Docs > Step-by-step guides for TulipFarm, a hosted workspace where AI agents help you run business operations. - Product site: https://tulipfarm.ai - Blog: https://tulipfarm.ai/blog/ - Sign in: https://app.tulipfarm.ai - Support: email hello@tulipfarm.ai. - Billing: there is no self-serve billing. To get more credits, contact support. - Changes that agents propose to your data or connected apps wait for a person's approval. - Every docs page is also available as Markdown: add `index.md` to the end of the page URL. Each link below opens that copy, and docs links inside it point to Markdown copies too. ## Get started Create an account, set up a workspace, and start your first chat. - [What is TulipFarm](https://tulipfarm.ai/docs/getting-started/index.md): TulipFarm is one workspace for business operations. You describe work in chat, and AI agents do it with your records, files, and approvals. - [Sign in to TulipFarm](https://tulipfarm.ai/docs/getting-started/sign-in/index.md): Sign in with an email link or with Google. There is no password to remember. - [Create or join a workspace](https://tulipfarm.ai/docs/getting-started/create-or-join-a-workspace/index.md): Create a new workspace for your company, or join an existing one from an invitation email. - [Tour of the workspace](https://tulipfarm.ai/docs/getting-started/workspace-tour/index.md): Learn the parts of the TulipFarm screen. The sidebar, the workspace menu, the account menu, Jump to, and Settings. - [Start your first chat](https://tulipfarm.ai/docs/getting-started/first-chat/index.md): Ask TulipFarm to do a business task in a new chat. Choose a model, attach files, and approve any proposed changes. - [Meet Bud](https://tulipfarm.ai/docs/getting-started/meet-bud/index.md): Bud is your built-in personal assistant in each TulipFarm workspace. It guides your first steps, offers suggestions, and learns how you like replies. ## Core concepts Learn what workspaces, agents, tables, and approvals are. - [Core concepts](https://tulipfarm.ai/docs/concepts/index.md): The main ideas behind TulipFarm. Learn what workspaces, chats, agents, tables, files, approvals, and credits are, and how they fit together. - [What TulipFarm is](https://tulipfarm.ai/docs/concepts/what-is-tulipfarm/index.md): TulipFarm is a control panel for business operations carried out by AI agents. Learn how chat, definitions, data, and approvals fit together. - [Workspaces, members, and teams](https://tulipfarm.ai/docs/concepts/workspaces-members-and-teams/index.md): A workspace is your company's space in TulipFarm. Members belong to it with a role, and teams let you share access once for a group. - [Chats and projects](https://tulipfarm.ai/docs/concepts/chats-and-projects/index.md): A chat is a conversation with TulipFarm's AI. A project is a shared space where a team keeps its chats, files, and instructions together. - [Agents, skills, and workflows](https://tulipfarm.ai/docs/concepts/agents-skills-and-workflows/index.md): Agents, skills, and workflows each make work repeatable in a different way. Learn what each one is, who runs it, and when to use it. - [Tables and rows](https://tulipfarm.ai/docs/concepts/tables-and-rows/index.md): A table holds one kind of business record, such as customers or invoices. Each row is one record in that table. - [Files and Knowledge](https://tulipfarm.ai/docs/concepts/files-and-knowledge/index.md): Files is your file library in TulipFarm. Knowledge is the source material that your chats and agents can search and cite. - [Approvals: nothing changes until you say so](https://tulipfarm.ai/docs/concepts/approvals/index.md): TulipFarm proposes changes to your data and outside apps first. A change happens only after a person approves exactly what was shown. - [Saved, activated, and running](https://tulipfarm.ai/docs/concepts/saved-activated-running/index.md): Saving an agent, skill, or workflow does not turn it on. Learn the difference between saved, activated, and running in TulipFarm. - [Credits](https://tulipfarm.ai/docs/concepts/credits/index.md): Credits measure AI model usage in TulipFarm. The whole workspace shares one balance, and each new workspace starts with free credits. ## Guides Follow step-by-step instructions for everyday tasks. - [How-to guides](https://tulipfarm.ai/docs/guides/index.md): Step-by-step guides for everyday work in TulipFarm. Use chat, build agents and workflows, review changes, and work with tables and files. - [Use chat](https://tulipfarm.ai/docs/guides/use-chat/index.md): Start a chat, add files, choose a model, and rename, archive, delete, or compact a chat in TulipFarm. - [Work in a project](https://tulipfarm.ai/docs/guides/work-in-a-project/index.md): Create a project, add instructions, files, and members, and start chats that everyone in the project can read. - [Build an agent](https://tulipfarm.ai/docs/guides/build-an-agent/index.md): Create a saved agent in chat or by hand, turn it on, and run its first task. - [Schedule an agent or attach it to Slack](https://tulipfarm.ai/docs/guides/schedule-an-agent/index.md): Run an agent on a repeating schedule, or attach it to a Slack channel so people can ask it there. - [Review agent tasks](https://tulipfarm.ai/docs/guides/review-agent-tasks/index.md): Follow your agent tasks in My agent tasks, and approve or reject the exact row changes that an agent proposes. - [Create skills](https://tulipfarm.ai/docs/guides/create-skills/index.md): Ask chat to write a skill, or import a skill from a link. Then review and enable it so agents can follow it. - [Build a workflow](https://tulipfarm.ai/docs/guides/build-a-workflow/index.md): Build a workflow in chat, save and activate it, run it, and read its run history in TulipFarm. - [Start workflows from other apps](https://tulipfarm.ai/docs/guides/start-workflows-from-other-apps/index.md): Start a TulipFarm workflow from new data in Google Sheets, Google Forms, Notion, or HubSpot. You connect each source with a token. - [Work with tables](https://tulipfarm.ai/docs/guides/work-with-tables/index.md): Create a table in chat, add and edit rows, switch between Table, Board, and List layouts, search with Ask AI, and export rows to CSV. - [Manage files](https://tulipfarm.ai/docs/guides/manage-files/index.md): Upload, organize, and share files in TulipFarm, restore items from Trash, and add files to your Knowledge. - [Use the calendar](https://tulipfarm.ai/docs/guides/use-the-calendar/index.md): See your meetings, scheduled agents, workflows, and pending work in one calendar. Find free time and create Google Calendar events. ## Integrations Connect Slack, GitHub, Google apps, and other tools. - [Connect your apps](https://tulipfarm.ai/docs/integrations/index.md): A connection links TulipFarm to an outside app such as Gmail or Slack. Learn who can use each connection and which apps you can connect today. - [Connect Google apps](https://tulipfarm.ai/docs/integrations/google/index.md): Connect Gmail, Google Calendar, Drive, Sheets, Docs, and Slides. Each Google connection is private to you. - [Connect Slack](https://tulipfarm.ai/docs/integrations/slack/index.md): Connect Slack so that people can ask agents in Slack channels. Link your own Slack account so that agents act for you. - [Connect GitHub](https://tulipfarm.ai/docs/integrations/github/index.md): TulipFarm has two GitHub connections. GitHub is private to you. GitHub team is shared with selected people and teams. - [Connect Jira, Confluence, and Trello](https://tulipfarm.ai/docs/integrations/jira-confluence-trello/index.md): Connect Jira, Confluence, or Trello with your own account or a shared business account. Changes ask first. - [Start workflows from Notion, Google Forms, and HubSpot](https://tulipfarm.ai/docs/integrations/notion-forms-hubspot/index.md): Notion, Google Forms, and HubSpot only start workflows in TulipFarm. Chats and agents do not work in these apps. - [Custom MCP connections](https://tulipfarm.ai/docs/integrations/custom-mcp/index.md): Add an MCP server to give your chats and agents tools from another service. Review each tool before anyone can use it. ## Workspace admin Manage members, teams, models, and settings. - [Manage your workspace](https://tulipfarm.ai/docs/admin/index.md): Workspace admins manage members, teams, table access, models, and settings. Admin status does not give access to other people's work. - [Change workspace settings](https://tulipfarm.ai/docs/admin/workspace-settings/index.md): Change your workspace name and icon, find the workspace ID, leave the workspace, or close it for everyone. - [Invite and manage members](https://tulipfarm.ai/docs/admin/members-and-invitations/index.md): Invite people to your workspace by email, track invitations, change member roles, and remove access. - [Create and manage teams](https://tulipfarm.ai/docs/admin/teams/index.md): A team is a group of members. Grant access to tables, agents, and connections once per team instead of once per person. - [Set table access for teams](https://tulipfarm.ai/docs/admin/table-access/index.md): Choose what each team can do with each table. Admins grant permissions to read, create, update, and delete rows, and to manage the schema. - [Choose workspace models](https://tulipfarm.ai/docs/admin/models/index.md): Admins choose which AI model families each team can use, set fallbacks, and set how long chats are compacted. - [See workspace usage](https://tulipfarm.ai/docs/admin/usage/index.md): The Usage page shows how many credits your workspace has left and where they go, split by model, agent, or activity. ## Billing and credits Learn how credits work and how to ask for more. - [How credits are used](https://tulipfarm.ai/docs/billing/index.md): See what uses credits in TulipFarm, where to check your workspace balance, and what happens when the credits run out. - [Get more credits](https://tulipfarm.ai/docs/billing/get-more-credits/index.md): There is no self-serve top-up in TulipFarm. To get more credits, a workspace admin contacts TulipFarm support by email. ## Security and privacy Find out who can see your work and how long TulipFarm keeps your data. - [Who can see what](https://tulipfarm.ai/docs/security/index.md): Your chats, files, agents, and personal connections are private by default. Being a workspace admin does not add access to them. - [Approvals and agent permissions](https://tulipfarm.ai/docs/security/approvals-and-agent-permissions/index.md): Changes to your data or outside apps wait for your approval. Agents use your permissions and can never expand them. - [Data retention and deletion](https://tulipfarm.ai/docs/security/data-retention-and-deletion/index.md): How long TulipFarm keeps deleted chats, rows, and files, and what happens when an admin closes a workspace. - [Analytics and cookies](https://tulipfarm.ai/docs/security/analytics-and-cookies/index.md): TulipFarm analytics are optional. You choose to allow or reject them, and private inputs and workspace content are hidden. ## Self-hosting Run TulipFarm on your own servers and configure models, sign-in, and email. - [Self-host TulipFarm](https://tulipfarm.ai/docs/self-hosting/index.md): Run open-source TulipFarm on your own infrastructure. Learn the services, the two kinds of settings, the requirements, and the current limitations. - [Run TulipFarm with Docker Compose](https://tulipfarm.ai/docs/self-hosting/docker-compose/index.md): Install, upgrade, back up, restore, and troubleshoot a single-machine TulipFarm install with the bundled Docker Compose stack. - [Self-hosting configuration](https://tulipfarm.ai/docs/self-hosting/configuration/index.md): How TulipFarm reads configuration, the operator settings you supply, the settings setup generates, secret files, and encryption key rotation. - [Configuration reference](https://tulipfarm.ai/docs/self-hosting/configuration-reference/index.md): Every environment variable that the TulipFarm services and the self-hosted stack read, grouped by area, with services, requirement, and defaults. - [Supply settings from a secret store](https://tulipfarm.ai/docs/self-hosting/secrets/index.md): Deliver TulipFarm settings as environment variables from Doppler, Infisical, 1Password, Vault, a cloud secret manager, Kubernetes, or a file. - [Use any KMS](https://tulipfarm.ai/docs/self-hosting/kms/index.md): Protect TulipFarm operator settings and backups with SOPS and AWS KMS, GCP Cloud KMS, Azure Key Vault keys, Vault Transit, or age. - [Configure models on the server](https://tulipfarm.ai/docs/self-hosting/models/index.md): Connect Anthropic, OpenAI, xAI, Gemini, or Azure Foundry, add your own catalog and OpenAI-compatible endpoints, and set prices, roles, and embeddings. - [Configure sign-in](https://tulipfarm.ai/docs/self-hosting/sign-in/index.md): Set up email links, Google sign-in, optional passwords, and Cloudflare Turnstile bot protection for self-hosted TulipFarm, and keep the auth secret stable. - [Send email](https://tulipfarm.ai/docs/self-hosting/email/index.md): Configure how a self-hosted TulipFarm sends sign-in links and invitations through SMTP or Azure Communication Services, and how delivery retries. - [Set up personal GitHub integrations](https://tulipfarm.ai/docs/self-hosting/github/index.md): Register a GitHub OAuth App, choose scopes, and supply the six GitHub settings so members of a self-hosted TulipFarm can connect GitHub accounts. ## Troubleshooting Fix common problems with sign-in, agents, and uploads. - [Troubleshooting](https://tulipfarm.ai/docs/troubleshooting/index.md): Find the fix for common TulipFarm problems, such as sign-in links, blocked Google access, agents that do not start, and failed uploads. - [Sign-in problems](https://tulipfarm.ai/docs/troubleshooting/sign-in-problems/index.md): Fix a sign-in link that does not arrive or expired, a too-many-attempts message, or a Google sign-in error. - [Google connection problems](https://tulipfarm.ai/docs/troubleshooting/google-connection-problems/index.md): Fix problems when you connect Gmail, Google Calendar, Drive, Sheets, Docs, or Slides to TulipFarm. - [An agent cannot start](https://tulipfarm.ai/docs/troubleshooting/agent-cannot-start/index.md): Fix an agent that does not start. Check that its instructions are activated, that you have run permission, and that its model is available. - [Credits or models are unavailable](https://tulipfarm.ai/docs/troubleshooting/credits-or-models-unavailable/index.md): Fix blocked chats and agents when the workspace is out of credits or when no model is available to you. - [Unconfirmed changes](https://tulipfarm.ai/docs/troubleshooting/unconfirmed-changes/index.md): When TulipFarm can't confirm that a change happened, do not redo it. Check its status or use the recovery action. - [Upload problems](https://tulipfarm.ai/docs/troubleshooting/upload-problems/index.md): Fix uploads that fail because a file is too large, workspace storage is full, or a task can't read the file. - [Contact support](https://tulipfarm.ai/docs/troubleshooting/contact-support/index.md): Email hello@tulipfarm.ai for help. Include the action you tried, what happened, and your workspace reference. ## Glossary - [Glossary](https://tulipfarm.ai/docs/glossary/index.md): Plain definitions of the terms that TulipFarm uses, from Activate to Workspace URL, with links to learn more. ## Optional - [Complete documentation](https://tulipfarm.ai/docs/llms-full.txt): Every page above in one file, in the same order. - [TulipFarm product site](https://tulipfarm.ai/llms.txt): Availability, pricing, features, solutions and comparisons. - [TulipFarm Blog](https://tulipfarm.ai/blog/llms.txt): Product news, engineering notes and company updates, each post as Markdown.