# AI use cases for Nautilo (agentsea/nautilo)

Repo: [agentsea/nautilo](https://github.com/agentsea/nautilo) | Use cases: 3 | Page: https://dedupedai.com/use-cases/agentsea-nautilo/

Nautilo is a self-hosted, open source (MIT) workspace where people and their AI Genies work together in shared Rooms across desktop, mobile, and web.

This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL.

- Run Nautilo locally on a Mac and make a first document: https://dedupedai.com/use-cases/agentsea-nautilo/try-nautilo-locally-on-mac/
- Deploy a shared Nautilo server for your team: https://dedupedai.com/use-cases/agentsea-nautilo/deploy-shared-team-server/
- Build and check Nautilo from source before a code change: https://dedupedai.com/use-cases/agentsea-nautilo/build-and-test-nautilo-from-source/

## How to run Nautilo locally on a Mac and make a first document with Nautilo

Repo: [agentsea/nautilo](https://github.com/agentsea/nautilo) | Difficulty: Intermediate | Time: 1 hour | Basis: From the README

Start a private Nautilo on your Mac and write your first document with a Genie.

**Who it is for:** A solo creator or curious individual with a Mac who wants to try a self-hosted AI workspace before sharing it with anyone.

**The problem:** You want an AI helper that keeps your work on your own machine and lets you choose the models, without setting up a server first.

**The outcome:** A running local Nautilo with your own Genie and one document you created together.

### Steps

1. Install Docker Desktop and confirm it is running.
2. Get a model API key from the Models & API keys page at https://nautilo.ai/docs/operator/provider-keys.
3. Open the illustrated local guide at https://nautilo.ai/docs/operator/deploy/local and follow it step by step.
4. Meet your Genie, give her a personality, and create your first document together.

### Prompt to paste into your agent

```text
Using the agentsea/nautilo repo and its local guide at https://nautilo.ai/docs/operator/deploy/local, walk <user> through a local Nautilo setup on macOS with Docker Desktop and a model API key. Report each step completed and the document created. Verify that Docker Desktop is running before starting.
```

### Caveat

Nautilo is in alpha, and the README says the local guide is the path for this setup, so expect rough edges.

Risk, credentials: Your model API key gives access to a paid provider account, so store it carefully and do not paste it into shared documents.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/agentsea-nautilo/try-nautilo-locally-on-mac/

## How to deploy a shared Nautilo server for your team with Nautilo

Repo: [agentsea/nautilo](https://github.com/agentsea/nautilo) | Difficulty: Advanced | Time: 2 hours | Basis: From the README

Host your own Nautilo on a datacenter machine or VPS so your team shares one Room.

**Who it is for:** A team lead or operator who wants several people and their Genies working in one self-hosted space, with control over who gets access.

**The problem:** Your team wants a shared AI workspace, but you do not want to hand your conversations and models to a third-party service.

**The outcome:** A team Nautilo server running on your infrastructure, with access limited to people you choose.

### Steps

1. Prepare a Linux server or VPS you control.
2. Follow the deployment guide at https://nautilo.ai/docs/operator/deploy/linux-server.
3. Configure your model choices and API keys using https://nautilo.ai/docs/operator/provider-keys.
4. Review https://nautilo.ai/docs/security and decide who gets access to the server.
5. Have teammates connect with Desktop, Mobile, or the web client and join a shared Room.

### Prompt to paste into your agent

```text
Using the agentsea/nautilo repo and its Linux server deployment guide, prepare a deployment plan for <server host> that lists required model API keys, access decisions, and security steps. Output a checklist and verify that the plan covers the security and privacy guide before any server change is made.
```

### Caveat

The README describes deployment at a high level and points to external guides, so verify each deployment step against the current docs before running it.

Risk, credentials: The server holds your model API keys, so limit server access and rotate keys if the host is shared.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/agentsea-nautilo/deploy-shared-team-server/

## How to build and check Nautilo from source before a code change with Nautilo

Repo: [agentsea/nautilo](https://github.com/agentsea/nautilo) | Difficulty: Advanced | Time: 1 hour 30 minutes | Basis: From the README

Clone the monorepo, start a dev stack, and run the standard checks before you submit a change.

**Who it is for:** A developer or coding agent who wants to change Nautilo or contribute a fix and needs a working local build and the repo's standard checks.

**The problem:** Contributing to a monorepo with several apps and packages is hard to start without a clear setup and a clear set of checks to pass.

**The outcome:** A running dev stack for your own instance and a pass or fail report from the four standard checks.

### Steps

1. Run `git clone https://github.com/agentsea/nautilo.git`
2. Run `cd nautilo`
3. Run `bun install --frozen-lockfile`
4. Run `bun run dev-stack --instance my-nautilo-dev`
5. Follow the source development guide at https://nautilo.ai/docs/build/development/local-development to claim the instance and configure a model.
6. Run `bun run lint`, `bun run typecheck`, `bun run test:unit`, and `bun run lint:unused` before submitting a code change.

### Prompt to paste into your agent

```text
In a checkout of the agentsea/nautilo repo at <path>, confirm Bun 1.3.11 and Node 24.x are installed, then run bun run lint, bun run typecheck, bun run test:unit, and bun run lint:unused. Report pass or fail for each and the first error. Read AGENTS.md and README.ai before editing any file.
```

### Caveat

The README asks for Docker for local PostgreSQL and Logto infrastructure, and some integration checks need extra setup described in the testing guide.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/agentsea-nautilo/build-and-test-nautilo-from-source/
