⛏️ Fedorite

A Fedora-based, open-source security-testing operating system. Daily driver by day, hunting rig by night. Find the hidden structure.

Fedorite is a security distribution built on Fedora — think Kali or Parrot OS, but from the RPM world, where no serious equivalent yet exists. It ships as one live ISO that is both a clean KDE Plasma daily driver and a loaded hacking workstation, with tools delivered through a real package supply chain (dnf).

Named after the rare mineral fedorite — because a vulnerability, like a rare gem, is a valuable thing you have to dig for.

---

🚀 Try the tools (any Fedora machine)

sudo dnf copr enable kannan-08/fedorite-tools
sudo dnf install fedorite-tools-web

Repo: https://copr.fedorainfracloud.org/coprs/kannan-08/fedorite-tools

---

🗺️ Repository map

Path	What's inside
mines/	The documentation mine — start at mines/README.md
mines/minershandbook/	The step-by-step learning handbook (amateur → expert)
mines/museum/	Public face: origin lore, brand & palette, blog drafts, screenshots
mines/ARCHITECTURE.md	How the whole system is wired
mines/CONTRIBUTING.md	How to join the dig
packaging/	RPM recipes (.spec), the repo config, and the Kickstart
fedorite-live.ks	The live ISO blueprint (Kickstart)
scripts/	Build/dev helpers (VM drivers)
memory/	Project memory snapshots (Claude + Serena) — full build context

The big *.iso artifact is intentionally not tracked (see .gitignore) — it's a build output, not source.

---

📊 Status

Expedition	What	Status
1 — The Assay	Feasibility	✅ Done
2 — The First Ingot	First bootable ISO	✅ Done & boot-tested
3 — The Copper Forge	Public package repo (COPR)	✅ Live
Next	Wire repo into ISO; package more tools; 3-month daily-driver test	⏳

---

Built by an Architect (vision) and a Builder (execution). The full story is in mines/. Private repo — work in progress.