SOL
Warm clay
Setup guide

Up and running
in about 15 minutes.

Install Bithaus, give it a free brain, reach it privately from your phone, and hand it a lifelong memory. Everything below is free and stays on your Mac.

Step one

Install and meet your companion

Open the app and your pixel companion is home. No account, no sign-up. Bithaus lives on your Mac and manages it from there.

1

Open Bithaus

Download the Bithaus app, drag it to Applications, and open it. On first launch macOS may ask you to confirm , that is normal for a new app.

2

Say hello

Your companion greets you in whichever world you pick. Try the chat: ask it "how full is my disk?" It answers from your real machine, on-device.

Step two

A free brain with Ollama

Bithaus thinks with a local model so it costs nothing and works offline. Ollama runs that model on your Mac.

1

Install Ollama

Grab Ollama from ollama.com (free), install it, and it runs quietly in the background.

2

Pull a small, sharp model

A 7B instruct model is a great balance of speed and quality on Apple Silicon:

ollama pull qwen2.5:7b-instruct
3

Bithaus finds it automatically

That is your free, offline brain (Medium mode). Later you can optionally connect a heavier hosted model for the toughest tasks, but you never have to.

Step three

Arm it when you want it to act

Reading is always free and safe. Anything that changes your machine , writing files, running a command, clearing caches , waits behind a single toggle.

1

Flip "Write access" on

In the companion panel, turn on write access when you want it to do work. Turn it off and it goes back to read-only. Destructive actions still ask first, and deletes go to the Trash, never permanent.

2

It reports what it did

Every action comes back with a plain-English summary. No silent changes, ever.

Step four , private mobile access

Reach it from your phone, privately

Serve Bithaus over Tailscale, a free private network just for your own devices. Your phone talks to your Mac directly and encrypted , nothing is exposed to the public internet.

1

Install Tailscale on both devices

Install Tailscale on your Mac and on your phone (free), and sign in with the same account. They join the same private "tailnet" and can see each other by name.

2

Serve the Bithaus port over the tailnet

On your Mac, expose the app's local port to your tailnet (Bithaus serves on port 8080):

# share localhost:8080 privately on your tailnet tailscale serve --bg 8080

This does not open any port to the internet. Only your logged-in devices can reach it.

3

Open it on your phone

Find your Mac's private name in the Tailscale app (MagicDNS gives it a name like your-mac.tailnet.ts.net). Open that in your phone browser and Bithaus loads , the full companion, on your phone, wherever you are, still running entirely on your Mac. Add it to your home screen for an app-like icon.

Step five , a free brain that remembers

Give it an Obsidian memory

Point Bithaus at a free Obsidian vault and your companion gains a durable, private memory plus a knowledge library , notes it reads and writes, that follow you across devices for free.

1

Install Obsidian and make a vault

Obsidian is free (obsidian.md). Create a new vault, for example a folder called Companion Brain. A vault is just a folder of plain Markdown files , yours forever, no lock-in.

2

Point Bithaus at the vault

In Settings, set the memory folder to your vault path. Bithaus will store what it learns as notes there, and read them back for context, so it gets sharper over time and remembers your preferences.

# the vault is just a folder of Markdown , inspect it anytime ~/Documents/Companion Brain/
3

Sync it for free (optional)

Put the vault in your iCloud Drive folder and Obsidian syncs it across your Mac, iPad, and iPhone at no cost. Now the companion's memory is the same everywhere, and you can browse or edit it yourself anytime.

Questions

Good to know

Is Bithaus private?

Yes. Bithaus runs on your Mac and talks to a local model. There is no account and no cloud round-trip. Your files, chats, and machine data never leave your device.

Do I need the internet to use it?

No. With a local model via Ollama, Bithaus works fully offline. The internet is only needed if you optionally use a hosted model or a web-search tool.

Is the AI free?

Yes. Bithaus uses a free on-device model through Ollama for its everyday brain, so there are no usage fees. You can optionally connect a paid plan for a heavier model when a task really calls for it, but you never have to.

How do I use Bithaus on my phone?

Install Tailscale on your Mac and phone (both on the same free tailnet), then serve the Bithaus port over the tailnet with tailscale serve --bg 8080. Open your Mac's private name in the phone browser. It is encrypted and never exposed to the public internet.

What is the Obsidian brain?

Bithaus can read and write notes in a free Obsidian vault, giving the companion durable memory and a knowledge library. Sync the vault with iCloud and its memory follows you across devices, all for free.

Will it change things without asking?

No. Reading is always safe. Actions that change your machine wait behind a write-access toggle, destructive ones ask first, and deletes go to the Trash. Every action is reported back in plain English.

Get Bithaus See it in action