SarcasmOS is a personality-first voice assistant. The core idea is simple: take a smart assistant like Alexa or Google Home, then give it a face, a voice, and most importantly, a personality. Instead of answering like a neutral corporate box, SarcasmOS replies in Spanish with dry humor, sarcasm, and animated expressions inspired by Bender.

This project focusses on the software and AI side of the assistant, but it also includes various hardware elements, like multiple PCBs, sensors, motors, and quite a bit of 3D printing. The goal is to have a memorable, sarcastic, and show-like assistant that can be used both for fun and real tasks like controlling smart home devices, playing music reviewing your agenda, or answering questions..

Futurama is a classic tv show we love (and you should too). Bender is the most memorable character, and his sarcastic personality is a perfect fit for a voice assistant. We wanted to build a voice assistant that is not just a plain, neutral box, but one that has a personality and you won't just use it to get things done, but also to have fun and be entertainedd

SarcasmOS is designed to work in Spanish first.

The language model prompt, personality, expected user input, and generated responses are all tuned for Spanish. Other languages may work accidentally depending on the upstream model, but they are outside the intended behavior of this project.

• Listens to speech input.
• Transcribes speech to text.
• Generates Spanish answers with a sarcastic character voice.
• Converts the answer back to speech.
• Syncs audio playback with an animated face.
• Stores memory of past interactions.
• Has a web interface for chat, audio, history and configuration.
• Has integrated speaker and microphone.
• Custom animations for the eyes and mouth.
• 8k mouth display (128x64 pixels = 8192 pixels).

It is recommended to use the online google spreadsheet for the most up to date BOM with links and prices.

SarcasmOS already has a working web demo available here:

• Static web UI in Code/AI/Workflow/SarcasmOS-web.
• Local FastAPI backend with chat, audio, history, and status endpoints.
• STT, LLM, and TTS pipeline using configurable external services.
• Console view, full face view, and voice chat view.
• CAD files for the head/body.
• KiCad designs for the eye and mouth boards.
• Voice synthesis/cloning experiments and clip preparation tools.

The hardware firmware is still not finished, but a minimal prototype is already available at Code/(Brain, Eye, Mouth) respectively for each PCB.

For the already setup web demo, visit https://sarcasmos.pegoku.com/.

For the best experience and no ratelimiting, run the local web app.

From Code/AI/Workflow/SarcasmOS-web:

start-all.bat

On macOS/Linux:

./start-all.sh

This starts:

• Proxy (combines all services into 1 port for easy access): http://localhost:9000
• Frontend: http://localhost:5173
• Backend: http://localhost:8001

You can also start them separately:

python -m http.server 5173
python -m uvicorn backend.app:app --host 0.0.0.0 --port 80011

The backend reads environment variables from .env files, especially:

• Code/AI/Workflow/SarcasmOS-web/backend/.env
• Code/AI/Workflow/.env

Important variables:

• HACK_CLUB_AI_KEY, or separate provider keys.
• OPENROUTER_API_TOKEN for the language model.
• REPLICATE_API_TOKEN for STT/TTS if using Replicate.
• MINIMAX_VOICE_ID for the TTS voice.
• FFMPEG_PATH if ffmpeg is not available on PATH.

More technical detail:

• Code/AI/Workflow/SarcasmOS-web/README.md
• Code/AI/Workflow/SarcasmOS-web/PROJECT_OVERVIEW.md

Microphone / text
      |
      v
Web frontend
      |
      v
FastAPI backend
      |
      +--> STT: speech to text
      +--> LLM: Spanish personality response + tools (e.g. google calendar)
      +--> TTS: spoken answer
      +--> Local JSON history
      |
      v
Audio + animated face + future hardware expressions
expressions
e expressions

Built as a physical AI assistant project for Hack Club / Fallout. SarcasmOS is not trying to be polite. It is trying to be memorable..