The Code/Workflows Get Tiles

Workflow

Run a private AI assistant locally with Tiles

Tiles is one of the projects the Mozilla Foundation funds.

It runs models on your own machine, syncs chats between your devices with end-to-end encryption, and shares them over AT Protocol, so your chats never touch a Tiles server. Here’s how to set it up.

Set up Tiles 4 steps · macOS or Linux

1Install and run Tiles

Download Tiles for macOS or Linux, then open the Tiles app or run:

tiles run

2Link your devices and sync chats

In the app, select “Link a device” in the bottom-left corner. Keep both devices online with Tiles running. For the CLI:

# Replace placeholders with actual values, without angle brackets

# Laptop: copy its DID from the id field
tiles account

# Desktop: create a link token for that laptop
tiles link create <LAPTOP_DID>

# Transfer the token securely. Back on your laptop:
tiles link join <TOKEN> desktop  # save the other device as desktop
tiles link devices               # verify the link
tiles sync desktop               # sync

3Share a chat publicly or privately

In the app, select “Share” at the top-right of any chat. In the CLI:

# Connect your ATproto account if you haven't during onboarding
# (use your own handle, then complete browser sign-in)
tiles at login alice.bsky.social

# Then, inside the Tiles chat:
/share

Choose public for a readable session, or private to encrypt it before upload. Anyone with the complete private link can read the chat.

4Use a bigger machine’s GPU

Keep the chat on your laptop while another machine handles inference over Iroh. Get the ticket from the menu bar app on the GPU machine, or use the CLI:

# GPU machine: start inference and print a ticket
tiles server start
tiles remote share

# Laptop: connect using that ticket
tiles --remote <TICKET>

# GPU machine: stop sharing when you're done
tiles remote unshare

The remote machine processes your prompts, so use hardware you trust.