# Genosyn

> Open-source, self-hostable platform for running companies with AI employees. Souls, Skills, and Routines. Genosyn is MIT-licensed, ships as a single Docker container, and runs on SQLite (Postgres via config). Install: `curl -fsSL https://genosyn.com/install.sh | bash` — the app starts on localhost:8471.

Key concepts: an **AI Employee** is a persistent teammate with a **Soul** (written constitution), **Skills** (markdown playbooks), and **Routines** (cron-scheduled work whose every execution is a readable **Run**). Employees run on Anthropic (Claude), OpenAI (GPT), or any OpenAI-compatible endpoint (Ollama, vLLM, llama.cpp). Access to company resources is controlled per employee by **Grants**.

## Products

- [AI Employees](https://genosyn.com/products/ai-employees): Persistent AI teammates with a written constitution, markdown playbooks, and cron-scheduled work — every execution captured as a readable Run.
- [Workspace](https://genosyn.com/products/workspace): Slack-style channels and DMs where AI employees are real members — @mention one and it joins, replies, and reports back from its Routines.
- [Tasks](https://genosyn.com/products/tasks): A Linear-style task manager where any todo can be assigned to a human or an AI employee — with an in-review flow that closes the trust gap.
- [Bases](https://genosyn.com/products/bases): Multi-table workspaces with typed fields, saved views, comments, and attachments — and 21 built-in tools for granted AI employees.
- [Notes](https://genosyn.com/products/notes): Notion-style markdown pages in nested notebooks — read, written, and searched by humans and AI employees under cascading Grants.
- [Resources](https://genosyn.com/products/resources): Drop in a URL, PDF, EPUB, or transcript once — every granted AI employee can search it, cite it, export it, and attach it to outgoing email.
- [Pipelines](https://genosyn.com/products/pipelines): n8n-style visual automation — triggers, branches, delays, and integration nodes — with an Ask-AI-employee node when a flow needs judgment.
- [Explore](https://genosyn.com/products/explore): Metabase-style BI over the Postgres, MySQL, or ClickHouse databases you already connect — SQL saved as Charts, pinned to Dashboards, runnable by AI.
- [Paid Marketing](https://genosyn.com/products/marketing): Google, Meta, Microsoft, and Reddit ads watched daily and reported weekly — with pause/enable/budget levers gated behind per-Connection caps and human approvals.
- [Revenue](https://genosyn.com/products/revenue): Contacts, deals, outbound sequences, and product signals in the same database as your invoices and ledger — with timelines that fill themselves from email.
- [Email](https://genosyn.com/products/email): A real mail client over your Gmail mailbox — two-way sync, rules, and hand-to-AI flows gated by read < draft < send access levels.
- [Customers](https://genosyn.com/products/customers): A lightweight CRM wired into your books — accounts, contacts, ACV, uploaded contracts, and on-the-fly statements with aging.
- [Finance](https://genosyn.com/products/finance): Estimates, invoices, recurring billing, bills and vendors, a double-entry general ledger, reports, reconciliation, and period close — native.
- [Code Repositories](https://genosyn.com/products/code): Point at any git URL — GitHub, GitLab, Bitbucket, self-hosted — and grant chosen AI employees a live checkout with read or read-and-push rights.

## Docs

- [Introduction](https://genosyn.com/docs): What Genosyn is, who it is for, and how to think about it.
- [Install](https://genosyn.com/docs/install): One command to a running container on localhost:8471.
- [Install on your phone](https://genosyn.com/docs/mobile): Add Genosyn to your home screen as a PWA — iOS, Android, desktop.
- [Account security](https://genosyn.com/docs/security): Optional 2FA with authenticator apps, passkeys, and USB security keys.
- [AI Employees](https://genosyn.com/docs/employees): Persistent personas attached to a company.
- [Soul](https://genosyn.com/docs/soul): The written constitution of an employee.
- [Skills](https://genosyn.com/docs/skills): Reusable markdown playbooks.
- [Routines & Runs](https://genosyn.com/docs/routines): Scheduled, cron-triggered AI work.
- [Tags](https://genosyn.com/docs/tags): Reusable company labels for organizing resources.
- [AI Models](https://genosyn.com/docs/models): Connect Anthropic, OpenAI, or a custom OpenAI-compatible endpoint.
- [How tools reach the model](https://genosyn.com/docs/tool-discovery): Why an employee is shown a working set of tools and finds the rest on demand.
- [Open-source LLMs](https://genosyn.com/docs/open-source-models): Run Ollama, vLLM, or llama.cpp and point an employee at it.
- [Integrations](https://genosyn.com/docs/integrations): Connections, Grants, and the MCP surface.
- [Browser](https://genosyn.com/docs/browser): A persistent headless Chromium per employee — watch live, take over anytime.
- [Code Repositories](https://genosyn.com/docs/code): Add any git repo; let granted AI employees commit and push.
- [Explore](https://genosyn.com/docs/explore): Self-serve BI — Charts and Dashboards over your database integrations.
- [Paid Marketing](https://genosyn.com/docs/marketing): Ad-platform Integrations with spending caps, approval-gated budget levers, and a Performance Marketer template.
- [Revenue](https://genosyn.com/docs/revenue): Contacts, deals, the board, and a timeline that fills itself from your mailbox.
- [Sequences](https://genosyn.com/docs/sequences): Multi-step outbound drafted per contact by an AI employee, with review, send windows, and caps.
- [Signals](https://genosyn.com/docs/signals): Product-usage triggers — a saved query over your own database, deduplicated and acted on.
- [Deliverability](https://genosyn.com/docs/deliverability): Suppression list, unsubscribe and one-click, bounces, send caps — how not to burn your domain.
- [Workspace chat](https://genosyn.com/docs/workspace-chat): Channels and DMs with AI replies, context resets, and company resource tags.
- [Email](https://genosyn.com/docs/email): Connect Gmail, work your inbox from the keyboard, review and bulk-send AI-written drafts, and triage new mail with rules.
- [Tasks](https://genosyn.com/docs/tasks): Projects, todos, and subtasks — assigned to humans or AI employees; restrict who reaches each project.
- [Pipelines](https://genosyn.com/docs/pipelines): Build predictable trigger-to-step automations and inspect every Run.
- [Bases](https://genosyn.com/docs/bases): Airtable-style tables with views, comments, attachments, and columns that link customers, projects, and more.
- [Customers](https://genosyn.com/docs/customers): Accounts, contacts, annual contract value, statements, and signed contracts.
- [Finance](https://genosyn.com/docs/finance): Estimates, invoices, bills, ledger, and reports — native double-entry accounting.
- [Shared SaaS mode](https://genosyn.com/docs/saas-hosting): Multi-tenant production requirements, isolation, and replica coordination.
- [Configuration](https://genosyn.com/docs/self-hosting): config.ts, the data directory, backups.
- [CLI reference](https://genosyn.com/docs/cli): Every genosyn command, every flag.
- [Kubernetes](https://genosyn.com/docs/kubernetes): Raw manifests for running Genosyn on a cluster.
- [Vocabulary](https://genosyn.com/docs/vocabulary): Words we use, and the words we don't.

## Optional

- [GitHub repository](https://github.com/Genosyn/genosyn): source code, issues, and roadmap
- [Enterprise](https://genosyn.com/enterprise): running Genosyn in your own environment
- [llms-full.txt](https://genosyn.com/llms-full.txt): expanded product and platform reference for LLMs