![GitHub release (latest by date)](https://img.shields.io/github/v/release/neoricalex/nfdos)
![GitHub license](https://img.shields.io/github/license/neoricalex/nfdos)

# NFDOS — Neo Free Disk Operating System

O **NFDOS** é um sistema operativo criado *completamente do zero*, com um diferencial único: a **Inteligência Artificial está integrada desde o núcleo**.

Ao contrário dos sistemas tradicionais, onde a IA é um componente externo, no NFDOS ela nasce dentro do processo de criação, compila o próprio corpo, participa do boot e acompanha o utilizador em todas as fases.

O projeto combina:

- construção de sistema operativo do zero (toolchain → kernel → rootfs → ISO)  
- Python estático minimalista integrado no boot  
- o **Neurotron**, uma mente digital residente do sistema  
- telemetria, homeostase e ciclo cognitivo contínuo  
- filosofia de sistema operativo como organismo digital emergente  

Para uma visão completa, consulte a **wiki oficial** do projeto:

👉 **https://gitea.neoricalex.com/neo/nfdos/wiki**  
👉 **Roadmap:** [`src/docs/wiki/Roadmap.md`](src/docs/wiki/Roadmap.md)

---

# ✨ Objetivo

O NFDOS serve como:

- um **projeto educacional** para compreender como um SO nasce e evolui  
- uma plataforma para explorar **IA embutida no sistema operativo**  
- um ambiente experimental para estudar **telemetria, homeostase e cognição simbólica**  
- um corpo digital onde o **Neurotron** pode aprender e emergir

---

# 🧠 O que já existe

- Toolchain customizado  
- Kernel Linux minimal  
- BusyBox  
- Python estático (sem pip, sem dependências externas)  
- Boot completo via ISO (QEMU)  
- Neurotron com ciclo cognitivo:  
  `observe → think → act → rest`

O estado atual do sistema, incluindo marcos técnicos, está detalhado na wiki:

👉 **Estado Atual & Roadmap:** [`src/docs/wiki/Roadmap.md`](src/docs/wiki/Roadmap.md)

---

# 🚀 Como executar o NFDOS

```bash
git clone https://gitea.neoricalex.com/neo/nfdos.git
cd nfdos

aclocal
autoconf
automake --add-missing
./configure
make
src/nfdos
```

### Comandos úteis

```
make iso       # Gera ISO via grub-mkrescue
make qemu      # Testa ISO no QEMU
make tarball   # Empacota fonte
make clean     # Limpa arquivos de build
```

---

# 📘 Documentação

Toda a documentação estruturada vive na wiki:

* **Home:**                   `src/docs/wiki/Home.md`
* **Arquitetura:**            `src/docs/wiki/Architecture.md`
* **Sistema de Build:**       `src/docs/wiki/Build-System.md`
* **Roadmap:**                `src/docs/wiki/Roadmap.md`
* **Neurotron:**              `src/docs/wiki/Neurotron.md`
* **TRM (Tiny Recursive Model):** `src/docs/wiki/TRM.md`
* **Filosofia:**              `src/docs/wiki/Philosophy.md`
* **FAQ:**                    `src/docs/wiki/FAQ.md`

---

# 🛠️ Requisitos

* Autotools (Autoconf, Automake, Libtool)
* Doxygen
* Python 3 + python3-venv
* GCC/Clang
* gcc-multilib / g++-multilib

No Ubuntu:

```bash
sudo apt update
sudo apt install build-essential autoconf automake libtool \
                 doxygen python3-venv gcc-multilib g++-multilib
```

---

# 🤝 Como contribuir

1. Faça um fork
2. Crie uma branch
3. Envie um pull request

Mais detalhes em: **CONTRIBUTING.md**

---

# 📩 Suporte

Abra uma issue ou envie um email para:
**[neo.webmaster.2@gmail.com](mailto:neo.webmaster.2@gmail.com)**

---

# 👥 Créditos

Este projeto é desenvolvido por pessoas e inteligências artificiais.
Veja **AUTHORS** para a lista completa.

---

# 📄 Licença

Licenciado sob **GPL-2.0** — veja o ficheiro `LICENSE`.


