README.md

---
title: NACC - Network Agentic Command Control
emoji: 🚀
colorFrom: blue
colorTo: purple
sdk: gradio
app_file: app.py
pinned: false
license: mit
short_description: AI-Powered Network Orchestration via MCP

tags:
- mcp-in-action-track-enterprise
- mcp-in-action-track-consumer
- mcp-in-action-track-creative
- building-mcp-track-enterprise
- building-mcp-track-consumer
- building-mcp-track-creative
---

# 🚀 NACC: Network Agentic Command Control

> **AI-powered orchestration for distributed systems using Model Context Protocol (MCP)**

NACC transforms multiple computers into a unified intelligent network, controllable through natural language. Built from scratch for the HF MCP Birthday Hackathon 2025.

---

### 🎥 **Demo & Social**

📺 **[Watch Full Demo Video](demovideo.mp4)** - See NACC controlling Mac and Kali Linux in action!

💼 **[LinkedIn Post](https://www.linkedin.com/posts/vasanthadithya-mundrathi-84a54031a_mcp-modelcontextprotocol-mcpbirthday-activity-7400561851106897920-0i1u?utm_source=share&utm_medium=member_desktop&rcm=ACoAAFDhpLoBNcrQ4qiK_sGt54NWi9Zd-0VanIM)** - Read about the journey and challenges

---

---
 
 ## 🏆 Hackathon Tracks & Justification
 
 We are submitting NACC for **all 3 tracks** because it represents a fundamental shift in how MCP can be applied across different domains.
 
 ### 🏢 **Enterprise Track** (`mcp-in-action-track-enterprise`, `building-mcp-track-enterprise`)
 **Why it fits:**
 - **Infrastructure Orchestration**: NACC solves a massive enterprise pain point - managing distributed servers and VMs. Instead of manual SSH, DevOps teams can use natural language to orchestrate complex workflows across hundreds of nodes.
 - **Security First**: Built with a custom secure handshake protocol and whitelisted command execution, designed for sensitive corporate networks.
 - **Scalability**: The hub-and-spoke architecture allows unlimited nodes to be added dynamically, perfect for large-scale server farms.
 
 ### 🏠 **Consumer Track** (`mcp-in-action-track-consumer`, `building-mcp-track-consumer`)
 **Why it fits:**
 - **Home Automation for Geeks**: Imagine controlling your home media server, Raspberry Pi, and gaming rig from a single chat interface. "Check if my Plex server is running" or "Update my Pi-hole" becomes a simple text message.
 - **Accessibility**: Lowers the barrier to entry for managing home labs. You don't need to know complex Linux commands; you just need to know what you want to do.
 
 ### 🎨 **Creative Track** (`mcp-in-action-track-creative`, `building-mcp-track-creative`)
 **Why it fits:**
 - **Novel Architecture**: We pioneered a **"Two-Space Architecture"** (Gradio + Docker) connected via a custom HTTP bridge to simulate a real network within HuggingFace's constrained environment.
 - **Agentic Innovation**: NACC isn't just a chatbot; it's an **autonomous agent** that plans, routes, and executes tasks across physical boundaries. It "thinks" in network topology.
 - **Built from Scratch**: We didn't use any pre-existing MCP SDKs. We built the entire MCP protocol implementation (JSON-RPC, tool registry, handshake) from zero to demonstrate deep understanding and creative application of the spec.
 
 ---
 
 ## 🎯 HuggingFace Space Demo

### Quick Start

1. **List nodes**: `list nodes`
2. **Switch to VM**: `switch to vm-node-01`
3. **Explore files**: `list files` → `navigate to /app/src`
4. **Try file ops**: `navigate to /tmp` → `create a file named demo.txt with content Hello!`

### Demo Instructions

📚 **Full demo guide available in the UI** - Open "Help & Instructions" accordion at the bottom

**Key Points**:
- VM Space (`vm-node-01`) - Remote node simulation
- File operations work in `/tmp/` directory
- Use absolute paths for navigation: `/app/src`, `/tmp`
- AI-powered natural language commands

---

## 🏆 For Judges

### What Makes NACC Special

**Built from Zero**: Every line of code written from scratch. No pre-made MCPs, no templates - pure original implementation.

**Original Vision**: NACC was designed for **real network environments** - controlling multiple PCs, servers, and VMs on the same network with full system access.

**Space Adaptation**: To showcase on HuggingFace Spaces, I created a unique two-space architecture:
- **Main Space**: Orchestrator + UI (this space)
- **VM Space**: Simulated remote node
- **HTTP Bridge**: Connects both spaces to simulate network communication

**Trade-offs**: Limited operations to protect running code. Real NACC (see demo videos) has full filesystem access, file sharing, and multi-node orchestration.

**Features**:
- ✅ Natural language command interpretation
- ✅ AI-powered tool selection and routing
- ✅ Cross-space file operations
- ✅ System monitoring and node management
- ✅ MCP protocol implementation

---

## 💬 To The Community

Thank you for checking out NACC! This project represents months of learning and experimentation with AI agents and distributed systems.

**About Me**: Vasanthadithya - 3rd year B.E. CSE student at CBIT, Hyderabad

**Looking For**: Internship opportunities, learning experiences, and chances to work on real-world AI/security projects.

If you like this approach to network orchestration, let's connect! I'm passionate about building secure, autonomous systems from the ground up.

📧 **Reach out**: [LinkedIn](https://www.linkedin.com/in/vasanthadithya-mundrathi-84a54031a/) | [GitHub](https://github.com/Vasanthadithya-mundrathi)

---

## 🛠️ Architecture

### Two-Space Setup

```
┌──────────────────────────┐
│   Main Space (This)      │
│   - UI + Orchestrator    │
│   - AI Backend (Blaxel)  │
│   - hf-space-local node  │
└────────┬─────────────────┘
         │ HTTP
         ↓
┌──────────────────────────┐
│   VM Space               │
│   - NACC Node Server     │
│   - vm-node-01           │
│   - Isolated filesystem  │
└──────────────────────────┘
```

### Real NACC (Local Network)

```
┌────────────┐      ┌────────────┐
│  MacBook   │      │ Kali Linux │
│  (Node)    │      │  (Node)    │
└─────┬──────┘      └──────┬─────┘
      │                    │
      └─────────┬──────────┘
                │
         ┌──────┴──────┐
         │ Orchestrator│
         │  (AI Brain) │
         └─────────────┘
```

---

## 🤖 Tech Stack

- **Frontend**: Gradio
- **Backend**: FastAPI
- **AI**: Blaxel (GPT-4o-mini) + fallback regex
- **Protocol**: MCP (Model Context Protocol)
- **Communication**: HTTP/REST
- **Language**: Python 3.10+

---

## 📺 Links

- **GitHub**: [Vasanthadithya-mundrathi/NACC](https://github.com/Vasanthadithya-mundrathi/NACC)
- **VM Space**: [NACC-VM](https://huggingface.co/spaces/MCP-1st-Birthday/NACC-VM)
- **Creator**: [@Vasanthfeb13](https://huggingface.co/Vasanthfeb13)

---

Built with ❤️ for **HF MCP Birthday Hackathon 2025** 🎂