nfdos/README.md
neo.webmaster.2@gmail.com 4f9c441688
Some checks are pending
Build NFDOS ISO / build (push) Waiting to run
"Auto-commit via make git"
2025-11-30 02:38:14 +01:00

139 lines
3.5 KiB
Markdown

![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`.