Skip to content

Releases: gamerg21/sous-chef

Release list

v0.1.0

v0.1.0 Pre-release
Pre-release

Choose a tag to compare

View all tags
@gamerg21 gamerg21 released this 22 Dec 13:12
v0.1.0
00f4bb8

Status: Early alpha (v0.1.0)

This release is intended for:

  • Self-hosters and home-lab users
  • Early contributors and testers
  • Developers interested in privacy-first kitchen tools

Not yet recommended for non-technical households.

Sous Chef v0.1.0 - Initial Release 🍳

Release Date: December 2025

We're excited to announce the initial release of Sous Chef, an open-source, self-hostable personal kitchen assistant. This first version establishes the foundation for managing your household's pantry, recipes, and shopping lists while maintaining complete privacy and control.

🎉 What's New

Core Features

🔐 Authentication & User Management

  • Email/password authentication with secure password hashing (bcrypt)
  • Household-based access control with role-based permissions
  • User roles: Owner, Admin, and Member
  • App-level admin interface for user management
  • User preferences including measurement system (metric/imperial) and default units

🏠 Household Management

  • Multi-user household support - share your kitchen with family members
  • Kitchen locations - organize inventory by Pantry, Fridge, and Freezer
  • Household member management with role assignment
  • Settings page for household configuration

📦 Inventory Management

  • Track inventory items across different kitchen locations
  • Unit-level quantities (e.g., 2 eggs, 500g rice)
  • Expiration date tracking per item instance
  • Photo attachments for inventory items
  • Barcode scanning (UPC/EAN) for quick item entry
  • Category organization for better inventory management
  • Notes and metadata for each inventory item

📝 Recipe Management

  • Private recipe library - recipes are private by default
  • Recipe creation and editing with full CRUD operations
  • Ingredient-to-inventory mapping - link recipe ingredients to your inventory
  • Recipe steps with ordered instructions
  • Recipe metadata: servings, cooking time, tags, notes
  • Photo attachments for recipes
  • Recipe favoriting and last cooked tracking
  • Recipe import/export support (JSON format)

🛒 Shopping List

  • Shared household shopping list - one active list per household
  • Category grouping (Produce, Dairy, Meat & Seafood, Pantry, Frozen, Bakery, Other)
  • Check-off functionality for items while shopping
  • Barcode scanning for adding items
  • Manual item entry with quantities and units
  • Item sources: manual, from-recipe, or low-stock
  • Clear checked items after shopping

👨‍🍳 Cooking & Planning

  • "What can I cook?" discovery based on available inventory
  • "Cook recipe" flow that automatically deducts inventory
  • Missing ingredients automatically added to shopping list
  • Recipe-to-shopping list integration

🌐 Community Features

  • Community recipe catalog - browse recipes shared by others
  • Recipe publishing - share recipes with the community (public/unlisted)
  • Recipe likes and saves - interact with community recipes
  • Recipe discovery - find new recipes from the community
  • Community integrations page for managing shared content

🔌 Extensions & Integrations

  • Extension marketplace - discover and install extensions
  • Integration framework - connect with external services
  • AI provider settings - configure AI providers with your own API keys
  • Extension management - enable/disable and configure extensions

⚙️ Admin Features

  • User administration - manage all users in the system
  • User detail pages - view and edit user information
  • Household user management - manage members within households

📤 Media & File Management

  • Photo uploads for recipes and inventory items
  • Media asset management with Supabase storage integration

🛠️ Technical Highlights

Architecture

  • Next.js 16 with App Router
  • React 19 with TypeScript
  • Prisma ORM with PostgreSQL database
  • Supabase-compatible backend (self-hostable)
  • NextAuth.js for authentication
  • Tailwind CSS for styling

Database

  • PostgreSQL as the primary database
  • Comprehensive schema supporting all core features
  • Row-level security ready (Supabase RLS compatible)
  • Migration-based schema management with Prisma

Development & Deployment

  • Docker support - easy self-hosting with Docker Compose
  • Local development with Supabase CLI
  • Environment-based configuration
  • Type-safe API routes with TypeScript

📋 Installation & Setup

Prerequisites

  • Node.js 20 LTS
  • pnpm (or npm/yarn)
  • Docker (for local Supabase development)

Quick Start

  1. Clone the repository
  2. Install dependencies: pnpm install
  3. Start Supabase locally: pnpm supabase start
  4. Configure environment variables (see .env.example)
  5. Run migrations: pnpm prisma migrate dev
  6. Start development server: pnpm dev

For detailed setup instructions, see the README.md.

Docker Deployment

Sous Chef can be deployed using Docker Compose. See DOCKER.md for complete deployment documentation.

🔒 Security & Privacy

  • Self-hostable - run on your own infrastructure
  • No vendor lock-in - use your own database and storage
  • Open source - full source code available
  • AGPL-3.0 licensed - ensures freedom and community contribution
  • Household-scoped data - all data is isolated by household
  • Secure authentication - bcrypt password hashing, secure session management

📚 Documentation

  • README.md - Project overview and setup instructions
  • DOCKER.md - Docker deployment guide
  • HTTPS_SETUP.md - HTTPS configuration guide
  • Product plan - Detailed feature specifications

🎯 What's Next

This initial release establishes the core foundation. Future releases will focus on:

  • Meal planning and cooking workflows
  • Shopping list automation
  • Nutrition analysis
  • Mobile-first UI polish
  • Import from external recipe sources
  • Enhanced mobile experience with offline support
  • Advanced AI meal planning features
  • Additional integrations and extensions
  • Performance optimizations
  • UI/UX improvements based on community feedback

🤝 Contributing

Sous Chef is in early development. Contributions are welcome! Please check the repository for contribution guidelines (coming soon).

📄 License

Sous Chef is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

This ensures:

  • Freedom to self-host
  • Freedom to modify
  • Required contribution back when used as a network service

See LICENSE for full text.

🙏 Acknowledgments

Thank you to all early contributors and the open-source community for making this release possible.

📞 Support

  • Issues: Report bugs and request features on GitHub
  • Documentation: See the README and docs folder
  • Community: Join discussions in the repository

Download: GitHub Releases

Full Changelog: This is the initial release.leases/tag/v0.1.0)

Full Changelog: This is the initial release.der

  • Community: Join discussions in the repository

Download: GitHub Releases

Full Changelog: This is the initial release.

Loading