What is shuna?

Shuna is a self hosted application meant to run your entire household kitchen from one place: what food you currently have, what you plan to cook, the shopping list that follows from that plan, and the recipes themselves. Because it runs on your own hardware rather than a company's servers, your kitchen data stays on your own network unless you deliberately choose to connect an outside AI service. Most existing kitchen apps either live in the cloud and keep your data, or only handle one piece of the puzzle, inventory, planning, or recipes, without connecting them together. Shuna's approach is to combine all four into a single self hosted app, and to make sure every AI powered feature has a plain, deterministic fallback, so the whole app still works fully even with AI turned off completely. Its inventory tracking uses real household units, like a bulb of garlic or a dozen eggs, rather than only weights, and items can be added by typing, scanning a barcode, or photographing a receipt. A weekly meal planner suggests meals based on what you actually have and what is close to expiring, and it can generate a shopping list that only includes what you are short on, price it against your local grocery store, and export it to other tools like Home Assistant. Recipes can be imported from a web link without any AI involved, or from a cooking video using AI assistance. The app also tracks expiring food, predicts when staple items need restocking based on your own past purchases, and supports multiple people sharing one household account, each with their own login. Running Shuna requires Docker and its Compose tool, optional extras include a locally run AI model through a tool called Ollama, a grocery pricing service, and Home Assistant integration, none of which are required for the core app to work. Setup is a matter of copying an example environment file, filling in a few passwords and secrets, and running one Docker command, after which the first account created automatically becomes the administrator. The backend is built with FastAPI and PostgreSQL, the frontend is a installable web app built with SvelteKit, and the whole project is licensed under the GNU Affero General Public License version 3, meaning modified versions run as a public service must also share their source code.