m3ta-nixpkgs

Personal Nix flake repository: custom packages, overlays, NixOS modules, and Home Manager modules.

Features

• 🎁 Custom Packages: Collection of personal Nix packages
• 🔄 Overlays: Package modifications and enhancements
• 🐚 Development Shells: Pre-configured environments (Python, DevOps)
• ⚙️ NixOS Modules: System-level configuration modules
• 🏠 Home Manager Modules: User-level configuration modules
• 📚 Library Functions: Helper utilities for configuration management
• ❄️ Flakes Only: Modern Nix flakes support (no channels)

Quick Links

• 📖 Full Documentation
• 🚀 Quick Start Guide
• 📚 Architecture
• 🤝 Contributing
• 📦 Packages
• ⚙️ Modules
• 📖 Guides

Quick Start

# Add to your flake
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
m3ta-nixpkgs.url = "git+https://code.m3ta.dev/m3tam3re/nixpkgs";

# Build a package
nix build git+https://code.m3ta.dev/m3tam3re/nixpkgs#code2prompt

# Run a package
nix run git+https://code.m3ta.dev/m3tam3re/nixpkgs#zellij-ps

Available Packages

See 📦 Packages for the full index with descriptions.

Quick reference — build any package directly:

nix build git+https://code.m3ta.dev/m3tam3re/nixpkgs#<package-name>
nix run git+https://code.m3ta.dev/m3tam3re/nixpkgs#<package-name>

Notable packages: sidecar, td, code2prompt, mem0, n8n, zellij-ps.

Automated Package Updates

This repository uses Gitea Actions to automatically update packages using nix-update:

Workflow: .gitea/workflows/nix-update.yml

Schedule: Runs weekly on Sundays, and can be triggered manually.

What it does:

• Checks all packages in pkgs/ for updates
• Updates versions and hashes using nix-update --flake --commit
• Creates a new branch with updates
• Opens a pull request automatically

Manual Trigger: Go to Actions → Update Nix Packages with nix-update → Run workflow in Gitea UI, then optionally specify a specific package to update.

Setup Required:

1. Create a Personal Access Token in Gitea (Settings → Applications → Generate Token)
2. Token scopes needed: user, repo, write:issue
3. Add token as secret: Settings → Secrets → New → NIX_UPDATE_TOKEN

For detailed usage, module documentation, package references, and contribution guidelines, see the full documentation.

License

Individual packages may have their own licenses. Check each package's meta.license attribute.

Maintainer

@m3tam3re