Process Manager for Tentarcles AI Origins

A robust process management system for the Tentarcles AI ecosystem that installs, runs, monitors, and controls origin packages as independent processes.

Features

• Package Installation: Install origin packages from GitHub or npm repositories
• Process Lifecycle Management: Start, stop, restart, and kill origin processes
• Process Monitoring: Track running processes with PID mapping and auto-cleanup
• Central Repository Integration: Search and register packages via Tentarcles RPC API
• Automated Dependency Handling: Manage dependencies in isolated environment
• TypeScript Support: Built with TypeScript and Bun runtime
• REST API: Full API for programmatic control

Core Modules

Process Module

• run(packageName): Start a package's main script from node_modules
• kill(packageName): Terminate a running process
• fetchRunningProcesses(): Get list of currently running origins
• Automatic process tracking and cleanup on exit

Package Module

• install(packageUrl): Install origin packages from GitHub/npm URLs
• fetchInstalledPackages(): List all installed origins
• search(query): Search central repository for available packages
• register(data): Register new packages to the central repository
• Private installRemote(): Notify central repository of installations

Quick Start

Using npx (Recommended)

npx ttc-origin-pm

Server starts on port 3092

Global Installation

npm install -g ttc-origin-pm
ttc-origin-pm

Local Installation

npm install ttc-origin-pm
npx ttc-origin-pm

Running as a Service

For production use, run the process manager as a background service:

Using PM2 (Recommended)

# Install PM2 globally
npm install -g pm2

# Start process manager
pm2 start "bun run start" --name ttc-origin-pm

# Auto-start on boot
pm2 startup
pm2 save

Linux (systemd)

Create /etc/systemd/system/ttc-origin-pm.service:

[Unit]
Description=TTC Origin Process Manager
After=network.target

[Service]
Type=simple
User=your-user
WorkingDirectory=/path/to/process-manager
ExecStart=/usr/bin/bun run start
Restart=on-failure

[Install]
WantedBy=multi-user.target

Enable with: sudo systemctl enable ttc-origin-pm.service

License

Part of the Tentarcles AI ecosystem.