Show HN: Anna – a voice assistant that reports your machine's load, RAM and disk

Developer Yankel Perelman released Anna, a developer-edition voice assistant that runs on a user's own machine or server with their own Gemini API key and reports the host's CPU load, RAM, disk and uptime by voice through Google's Gemini Live API. Anna runs in the browser (microphone to WebSocket to Gemini Live to speech), loads Python skills dropped into a skills/ folder at startup, includes a server-monitoring skill (skills/server_monitor_skill.py), stores a local conversation log in SQLite, and offers built-in web search via the ddgs metasearch library plus optional Telegram messages. Perelman notes the system prompt is "a soft guard, not a security boundary," and that a hard restriction requires removing tools from TOOLS and the tool handler in anna.py.

A small server with a web interface for talking to Gemini Live https://ai.google.dev/ by voice, with a plugin system for skills. Anna answers in the language the user speaks to her. This is the developer edition : you run it on your own machine or your own server with your own API key . A separate desktop edition for end users is planned. Not affiliated with Google. Gemini is a trademark of Google LLC. 📝 Write-up: Streaming microphone audio to Gemini Live from a browser https://dev.to/yankel perelman 96a1f31a6/streaming-microphone-audio-to-gemini-live-from-a-browser-what-i-learned-building-a-small-voice-16m7 - Real-time voice conversation in the browser microphone → WebSocket → Gemini Live → speech - Enter your Gemini API key on the web page validated against Google, stored with 0600 permissions - Model and voice drop-downs the model list is fetched from Google and filtered to Live-capable models - Live transcripts of both sides in the page - Built-in tools: web search via the ddgs metasearch library, which queries several engines such as DuckDuckGo and Wikipedia and optional Telegram messages - Skills : drop a Python file into skills/ and it is loaded at startup - Included skill: server monitoring skills/server monitor skill.py - Local conversation log in SQLite In this edition Anna is configured as a server monitoring and administration assistant . The system prompt SYSTEM INSTRUCTION in anna.py tells her to discuss only the server: load, memory, disk, uptime, and how to diagnose or maintain it. She can read live stats monitoring skill , search the web for administration answers for example how to free up memory , and send a report or a found how-to to your Telegram chat. She cannot run commands on the server, and she is told to warn about risky ones. Everything else is politely declined. Edit the prompt to change her role. A prompt is a soft guard, not a security boundary: a determined user may still talk the model into off-topic answers for example through the web search tool . If you need a hard restriction, remove tools from TOOLS and the tool handler in anna.py . git clone https://github.com/yankelperelman/anna-dev.git cd anna-dev python -m venv .venv Windows: .venv\Scripts\activate Linux/macOS: source .venv/bin/activate pip install -r requirements.txt python anna.py Open http://127.0.0.1:8010 http://127.0.0.1:8010 , paste your Gemini API key into the page, choose a model and a voice, and press Start conversation . Alternatively, put GOOGLE API KEY in a .env file: copy .env.example to .env . Browsers only allow microphone access on localhost or over HTTPS. To use the assistant on a remote server, either forward the port over SSH ssh -L 8010:127.0.0.1:8010 user@your-server or put it behind an HTTPS reverse proxy with authentication see Security . docker compose up -d --build Open http://127.0.0.1:8010 http://127.0.0.1:8010 and enter your key on the page or provide GOOGLE API KEY in a .env file . The port is published on localhost only. Logs: docker compose logs -f anna . - The conversation log and the key saved from the web page are kept in the anna-data volume. - ./skills is mounted read-only into the container, so you can add or edit skills and just restart docker compose restart anna . - Server monitoring inside Docker: the included skill reads CPU load, RAM and uptime from /proc , which a container shares with the host kernel, so those numbers describe the host. Disk usage describes the filesystem the skill is pointed at / inside the container, usually the disk holding Docker's data . To report another disk, mount it into the container and set ANNA MONITOR DISK PATH . Note that container memory limits are not reflected in these numbers. All settings come from environment variables or a .env file. | Variable | Required | Default | Description | |---|---|---|---| | GOOGLE API KEY | no | — | Your Gemini API key or enter it on the web page; a saved key wins | | ANNA KEY FILE | no | gemini key.txt | Where a key entered on the web page is stored | | GEMINI MODEL | no | gemini-3.8-live | Default model selectable on the page | | ANNA VOICE | no | Puck | Default voice selectable on the page | | ANNA HOST | no | 127.0.0.1 | Bind address | | ANNA PORT | no | 8010 | Port | | ANNA DB PATH | no | anna history.sqlite3 | Local conversation log | | ANNA MONITOR DISK PATH | no | / | Disk reported by the server monitoring skill | | ANNA ACCESS TOKEN | no | — | Secret for a publicly reachable server; open https://host/?token=... once per browser | | ANNA ALLOWED HOSTS | no | — | Your domain s when a reverse proxy rewrites the Host header | | ANNA SEARCH REGION | no | wt-wt | Region for web search results wt-wt = no bias, e.g. us-en , ru-ru | | TELEGRAM BOT TOKEN | no | — | Enables the Telegram tool | | TELEGRAM CHAT ID | no | — | Target chat for the Telegram tool | Skills live in the skills/ folder and are loaded by SkillRegistry when the server starts. Each skill can add tools function declarations and extra instructions for the model. Use skills/server monitor skill.py as a reference when writing your own. - By default there is no authentication , and the server listens on 127.0.0.1 only. If you publish it on a domain reverse proxy with HTTPS , set ANNA ACCESS TOKEN : without it anyone on the internet can talk to Anna, spend your API key, and replace or remove the saved key. With a token, open https://your-domain/?token=... once in each browser; a cookie is stored and the token disappears from the address bar. The token ends up in your proxy's access log, so treat it like a password and change it if it leaks. Your proxy must forward WebSocket connections Upgrade headers . - Requests from other websites are rejected Origin check . If your proxy rewrites the Host header, add your domain to ANNA ALLOWED HOSTS . - The API key itself is never sent back to the browser. - Web search queries are sent to third-party search engines and appear in the server log. - Never commit your .env or gemini key.txt . If a key was ever committed, treat it as leaked and revoke it. - Conversation transcripts are stored locally in the SQLite file. It is git-ignored; keep it that way. - The server monitoring skill lets the model read information about your server. What the model sees is sent to Google. Do not use it with data you are not allowed to share. You are responsible for complying with the current Gemini API Additional Terms of Service https://ai.google.dev/gemini/terms . Points that matter for this project summary, not legal advice : - Available regions only. Use the API only from regions where Google offers it. This project does not support, and must not be used for, bypassing regional restrictions. - 18+. You must be an adult; do not make this app available to minors. - Free tier and data. On the unpaid tier Google may use your prompts and responses including audio to improve its products, and human reviewers may read them. Do not send sensitive, confidential or personal information on a free key. - EEA, Switzerland, UK. If you make the app available to users there, only paid billing-enabled services may be used. - Your own key, your own use. This edition is meant for developers running it for themselves. Do not share your key or give other people access to your instance. Voices and models are offered as Google lists them; a voice that the chosen model does not support makes the session fail with an error, in which case pick another one. Terms change; check them before you rely on this summary. - Desktop edition for end users installer, bring-your-own paid key - Additional providers Vertex AI, OpenAI Realtime behind a common interface - Authentication for the web interface - More skills MIT — see LICENSE https://github.com/yankelperelman/anna-dev/blob/main/LICENSE .