Tuesday AI

Local-first, browser-based assistant designed to do things (multi-step work, tools, scheduling, notes), not just chat.

This repo currently contains:

• a FastAPI backend (agent/app/main.py)
• a minimal browser UI (web/index.html)
• integrations:
  • OpenWebUI (OpenAI-compatible)
  • Homebridge/HomeKit control (aiohomekit)
  • Notch (todos/notes)
  • ntfy (push notifications)
  • Open-Meteo weather
  • optional SearxNG search/fetch

Project docs

• Architecture + roadmap: ROADMAP.md
• Current snapshot (what it does now): TUESDAY-AI.md
• Plan checklist: plan.md

Quick start (dev)

Requirements

• Python 3.12+ recommended
• OpenWebUI reachable on your LAN

Setup

cd /home/legend/projects/tuesday
cp .env.example .env
./run.sh

Open:

• http://localhost:8091/ui

Configuration

Tuesday reads secrets/endpoints from .env (see .env.example).

Common vars:

• OPENWEBUI_BASE_URL, OPENWEBUI_API_KEY, OPENWEBUI_MODEL
• NOTCH_BASE_URL, NOTCH_SERVICE_TOKEN
• NTFY_BASE_URL, NTFY_DEFAULT_TOPIC

Security notes

This project controls real devices and will eventually run allowlisted commands.

• Do not expose it publicly without authentication.
• Prefer binding to 127.0.0.1 and putting a reverse proxy in front.
• Never commit .env.

License

MIT — see LICENSE.