# 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.
- [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.
- [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.
- [AI Models](https://genosyn.com/docs/models): Connect Anthropic, OpenAI, or a custom OpenAI-compatible endpoint.
- [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.
- [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.
- [Email](https://genosyn.com/docs/email): Connect Gmail, work your inbox, hand threads to AI employees, 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.
- [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.
- [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