Cyborg Conductor Core

A distributed system for efficiently managing Cyborgs and the physical resources they run on.

Definitions

Cyborg

A Cyborg is a logically isolated entity identified by a UUID. It bundles immutable capability specifications, either Deterministic executable handlers or Streamable LLM inference streams.

Cyborgs are described in a CyborgDescriptor protobuf with runtime state (current phase, active streams, and latency budgets) tracked separately in the CyborgFusionEnvelope protobuf to guarantee predictable execution and strong isolation across deployments.

Project Structure

.
├── cmd/                    # Command-line tools
│   └── server/             # Main server application
├── pkg/                    # Core packages
│   ├── core/               # Core data structures and types
│   │   ├── pb/             # Protobuf-generated types and registry
│   │   └── types/          # Core types
│   ├── config/             # Configuration management
│   ├── context/            # Context utilities
│   └── memory/             # Memory management and evidence logging
├── internal/               # Internal packages
│   ├── context/            # Context management components
│   ├── runner/             # Cyborg runner implementations
│   └── conductor/          # Job scheduling and orchestration
├── cyborgs/                # Cyborg management
│   └── [cyborg-id]/        # Individual cyborg directories
├── proto/                  # Protocol buffer definitions
├── adapters/               # Language adapters (Python, Node.js)
├── test/                   # Test suites
│   ├── unit/               # Unit tests
│   └── integration/        # Integration tests
├── docs/                   # Documentation
├── .github/workflows/      # CI/CD pipelines
└── go.mod                  # Go module file

Features

• Distributed Cyborg Management: Manage multiple Cyborgs across different environments.
• Adaptive Scheduling: Dynamic task assignment based on Cyborg capabilities.
• Back-pressure Handling: Intelligent flow control to prevent system overload.
• LLM Integration: Support for large language model streaming sessions.
• Observability: Comprehensive monitoring and admin interfaces.
• Production-Ready: Full CI/CD pipeline, security checks, and test coverage.

Deployment

Docker Deployment

# Build Docker image
docker build -t cyborg-conductor-core .

# Run container
docker run -p 8080:8080 cyborg-conductor-core

Kubernetes Deployment

# Create ConfigMap with schema
kubectl create configmap cyborg-schema --from-file=proto/

# Deploy with Helm chart
helm install cyborg-conductor ./charts/cyborg-conductor-core

Documentation

For detailed information about the Cyborg Conductor Core system, please refer to the following documentation:

• [User Guide] - Complete user documentation including getting started, Cyborg management, and use cases
• [Technical Design Document] - In-depth architectural and implementation details
• [Contributing Guidelines] - How to contribute to the project

---

Support My Projects

If you find this repository helpful and would like to support its development, consider making a donation:

GitHub Sponsors

Buy Me a Coffee

PayPal

Ko-fi

Coinbase

Your support helps maintain and improve this collection of development tools and templates. Thank you for contributing to open source!

License

This project is licensed under the MIT License - see the LICENSE file for details.