Set up with a computer.

What you need

Have these ready and the rest is answering questions.

• A computer that stays onA Mac, a Linux box or a Raspberry Pi. It runs the TV screen, the Guest remote and the helper, so it must never sleep.
• Python 3.10 or newerThe command checks, and says what to install if it is missing.
• Claude Code, signed inOnly for the guests' Ask box; the setup itself uses no AI. It runs on your own Claude plan. Get Claude Code.
• One Wi-Fi for everythingThe TV, the computer, the aircon and lights, and your guests' phones.
• Your answers readyThe guest Wi-Fi name and password, your TV's brand and address (on the TV: Settings, Network, your Wi-Fi, IP address), and for a stay your Airbnb calendar link (Calendar, Availability, Connect calendars, Export).
• The TV remoteFor the last few steps at the TV.

1. Run one command

   Open Terminal on the computer that stays on, paste this and press Return:

   git clone https://github.com/Seagey/guest-tv && cd guest-tv && sh scripts/start.sh

   Copy

   It sets up Python, checks what it needs first, and tells you how to fix anything missing.

2. Answer the questions

   In plain words, one at a time:

   • a guest room, or a place guests stay (Airbnb, holiday home)
   • your name, and the guest Wi-Fi
   • the Airbnb calendar link (stays only)
   • the TV's brand and address
   • which rooms guests may control for the aircon and lights
   • which streaming apps are signed in on that TV
   • how much the helper may do (Locked is the default)

   Run it again any time to change an answer.

3. Keep it running

   Say yes when it asks to start Guest TV now and after every restart. At the end it shows this computer's address: keep it handy.

   On a Mac, keep it awake: System Settings, Energy (or Battery, Options), Prevent automatic sleeping.

4. Put Guest TV on the TV

   On the TV, install Downloader from the app store, open it, type the code and press Go:

   Downloader code1061533

   Allow Downloader to install apps when the TV asks, then Install and Open. Guest TV finds the computer by itself. Every press is on TV setup, which is easier to follow with this page open on your phone at the TV.

5. Try it like a guest

   Scan the Guest remote code and ask for something. Then test the guard rails yourself: .venv/bin/python tools/agent_test.py runs 73 asks in about six minutes, and every one must pass.

Samsung, LG, Roku, Apple TV or another TV? Do steps 1 to 3, then follow your TV's guide on GitHub: Samsung and LG, or every other TV. Check your TV first to see what it can do. Prefer every step by hand over ADB? The long way.

Good to know

• Nothing on the TV is touched by the command. It only sets up the computer.
• The helper never bills an API key. It runs Claude Code on your plan with the API key stripped first.
• Undo is one line. See Remove it.