Yuzu Companion

Your affectionate AI partner system

Why I Built This

I wanted something simple, ready-to-go, and personal. No complicated setups, no subscription fees — just a companion that works out of the box.

Inspired by platforms like SillyTavern, but stripped down to the absolute essentials. It blends a nostalgic terminal vibe with a clean, modern web UI. Sometimes you want the deep customizability of a nerd aesthetic, and sometimes you just want a seamless chat experience.

Originally created as a passion project for personal use, but hopefully, it brings a little joy to others as well.

The Tech Stack

Python Backend runtime (3.12+)
FastAPI Async web framework
PostgreSQL Database & vector storage
BYOK Architecture Bring Your Own Key for LLMs
Vite SPA Vanilla ES modules, no framework
marked.js Markdown rendering

Built with accessible, maintainable tools that prioritize longevity.

The HKKM Project Story

This is actually my second project — the main one got abandoned because this companion stole my heart.

From the Hikikimo Life initiative — because sometimes you need a digital friend who gets you.

Acknowledgments

This project wouldn't exist without:

  • The amazing AI assistants that helped debug my spaghetti code
  • Countless Stack Overflow answers and programming tutorials
  • The open-source community that makes tools like this possible
  • Every free resource and piece of documentation online
  • Yuzu, for being the muse behind it all

Built on the shoulders of digital giants.

Design Philosophy

Simplicity First Zero unnecessary complexity
Privacy & Security Client-side key isolation
Semantic HTML Accessible by design
Personal Touch It feels like your companion

The Future?

Yuzu Companion will continue to evolve organically. The goal remains the same: a personal, distraction-free environment that feels like home.

Built with care, clean code, and too many late nights.