Quick Start Guide
Relevant source files
The following files were used as context for generating this wiki page:
The WIREDUP project is a revolutionary intelligent infrastructure system that integrates a Python-based AI Auto-Wiring engine with a high-performance Rust-based terminal (NexTerm). This guide provides the necessary steps to initialize, configure, and deploy the system across various environments, including local development setups and Cloudflare Pages for the web interface.
The system's scope encompasses automated dependency injection, environment management, and multi-agent orchestration. By following this guide, developers can establish a production-ready environment that leverages the Model Context Protocol (MCP) and secure SSH management for advanced AI communication and remote command execution.
Sources: README.md:1-15, DEPLOYMENT_STATUS.md:10-30
System Architecture Overview
The WIREDUP ecosystem consists of three primary layers: the Python AI Auto-Wiring System, the NexTerm Rust Terminal, and a responsive Web Interface. The Auto-Wiring Core serves as the central hub, managing dependencies for agents and services while interfacing with the configuration system and communication protocols.
The architecture facilitates seamless communication between high-performance terminal operations and complex AI logic.
Sources: README.md:21-41, QUICKSTART.md:95-115, public/index.html:150-175
Local Development Setup
Setting up the project locally requires configuring both the Python environment for the core engine and the Rust toolchain for the terminal.
Python System Initialization
The Python component handles the dependency injection engine and CLI management. It requires Python 3.8 or higher.
- Installation: Clone the repository and install dependencies.
git clone https://github.com/RemyLoveLogicAI/WIREDUP.git cd WIREDUP pip install -r requirements.txt - Initialization: Use the CLI to create the necessary configuration directories and templates.
python -m src.cli init - Execution: Start the auto-wiring engine.
python -m src.cli start
Sources: README.md:46-59, QUICKSTART.md:154-165, src/cli.py:40-100
Rust Terminal (NexTerm) Build
NexTerm provides the modern TUI and interfaces with the Python core via a bridge.
- Prerequisites: Ensure Rust 1.75+ is installed.
- Build: Navigate to the terminal directory and build the release binary.
cd rust-terminal cargo build --release - Integration: Set the environment variable to enable auto-wiring before running.
export NEXTERM_AUTOWIRE=true cargo run --release
Sources: rust-terminal/BUILD.md:3-20, QUICKSTART.md:170-185
CLI Tool Reference
The ai-wire (aliased to src.cli) tool is the primary interface for managing the auto-wiring system.
| Command | Description | Key Options |
|---|---|---|
init | Initializes config directories and .env templates | --env, --config-dir |
start | Loads configuration and initializes registries | --env |
status | Displays operational status of the auto-wire engine | N/A |
list-components | Lists all registered dependencies and their scopes | --category |
config | Retrieves a specific configuration value | key, --default |
ssh-exec | Executes a remote command via the SSH Manager | --host, --username |
Sources: src/cli.py:34-230, setup.py:33-37
Cloudflare Pages Deployment
The web interface located in the /public directory can be deployed as a static site to Cloudflare Pages.
Deployment Workflow
The deployment process is optimized for speed and automated through Git integration.
Build Configuration Settings
When creating the application in the Cloudflare Dashboard, use the following settings:
- Project Name:
wiredup - Production Branch:
main - Build Command: (Leave empty)
- Build Output Directory:
public
Sources: CLOUDFLARE_DEPLOY.md:11-30, DEPLOYMENT.md:10-25, QUICKSTART.md:17-45
Configuration Management
WIREDUP utilizes a multi-source configuration system involving .env files, JSON defaults, and environment-specific overrides.
Core Environment Variables
| Variable | Description | Default |
|---|---|---|
AI_ENV | Target environment (development/production) | development |
AI_LOG_LEVEL | Logging verbosity (INFO, DEBUG, ERROR) | INFO |
MCP_ENABLED | Enables Model Context Protocol support | true |
NEXTERM_AUTOWIRE | Enables Rust-Python bridge in the terminal | false |
SSH_KEY_PATH | Path to the default SSH private key | ~/.ssh/id_rsa |
Sources: README.md:100-118, src/cli.py:65-85, rust-terminal/BUILD.md:110-120
Conclusion
The WIREDUP system is now ready for production-grade use. By successfully initializing the Python Auto-Wiring engine and building the NexTerm Rust Terminal, developers gain access to an extensible framework for AI agent orchestration. Subsequent updates to the web interface are automatically handled via the Cloudflare Pages CI/CD pipeline, ensuring the project documentation and showcase remain synchronized with the core codebase.
Sources: DEPLOYMENT_STATUS.md:195-215, QUICKSTART.md:265-280