SpudNet

SpudNet is a system-integrated agentic daemon with a TUI menu that provides hardware-aware automation, real-time system monitoring, and cross-network project assistance on its host devices.

Requirements & Tech

• Python == 3.14.2
• blessed == 1.29.0
• ollama >= 0.4.0
• psutil == 3.3.14
• pydantic == 2.12.5

Architecture

You can view the architecture of the project at the ARCHITECTURE file.

Documentation

You can view the CHANGELOG to view more information.

Development Roadmap

• Phase 1 (The Nervous System): Focus on psutil integration and JSON snapshots.
• Phase 2 (The Cognitive Pipeline): Transition to the FastAPI daemon and SQLite.
• Phase 3 (The Workspace Layer): Implement watchdog for project indexing.
• Phase 4 (The Guardian): Focus on security, sudo logic, and Btrfs snapshots.
• Phase 5 (The Mesh Network): Networking and P2P synchronization.

Installation & Quick-Start

First, clone the repo and enter the project:

git clone https://github.com/SpudWorks-Labs/SpudNet
cd SpudNet

Second, create a virtual environment and install the requirements.

python -m venv env
source ./env/bin/activate
pip install -r requirements.txt

Then create the model by running the create_model.sh.

# In a separate terminal.
ollama serve

# Create the model
./create_model.sh

Finally, start the TUI client.

python main.py

• /clear: Wipes the terminal buffer.
• /kill: Safely terminate the session.

Important Acknowledgements

This project was made by human developers, with the use of AI Tooling.