{"id":35124347,"url":"https://github.com/colonyos/colonies","last_synced_at":"2026-01-27T23:41:44.149Z","repository":{"id":38523912,"uuid":"445483023","full_name":"colonyos/colonies","owner":"colonyos","description":"Colonies is a distributed framework to implement a meta-operating system.","archived":false,"fork":false,"pushed_at":"2026-01-02T07:54:56.000Z","size":259955,"stargazers_count":35,"open_issues_count":49,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-01-07T06:55:14.892Z","etag":null,"topics":["cryptography","distributed-systems","faas","faas-framework","kubernetes","operating-system","orchestration","zero-trust-security"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/colonyos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/Security.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-01-07T10:29:16.000Z","updated_at":"2026-01-02T07:19:32.000Z","dependencies_parsed_at":"2023-12-19T00:43:07.891Z","dependency_job_id":"fb5482ca-7dcf-494b-bdf4-f550eeeeef61","html_url":"https://github.com/colonyos/colonies","commit_stats":null,"previous_names":[],"tags_count":80,"template":false,"template_full_name":null,"purl":"pkg:github/colonyos/colonies","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colonyos%2Fcolonies","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colonyos%2Fcolonies/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colonyos%2Fcolonies/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colonyos%2Fcolonies/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/colonyos","download_url":"https://codeload.github.com/colonyos/colonies/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colonyos%2Fcolonies/sbom","scorecard":{"id":300336,"data":{"date":"2025-08-11","repo":{"name":"github.com/colonyos/colonies","commit":"d06283c5ea0acf2d78605ae368b5f36a1d510a00"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.6,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'contents' permission set to 'read': .github/workflows/docker_master.yaml:17","Warn: no topLevel permission defined: .github/workflows/docker_master.yaml:1","Warn: no topLevel permission defined: .github/workflows/go.yml:1","Warn: topLevel 'contents' permission set to 'write': .github/workflows/releaser.yaml:10","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: docs/Security.md:1","Info: Found linked content: docs/Security.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: docs/Security.md:1","Info: Found text in security policy: docs/Security.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Binary-Artifacts","score":9,"reason":"binaries present in source code","details":["Warn: binary detected: buildtools/codecov:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v1.8.18 not signed: https://api.github.com/repos/colonyos/colonies/releases/199481590","Warn: release artifact v1.8.17 not signed: https://api.github.com/repos/colonyos/colonies/releases/175078602","Warn: release artifact v1.8.16 not signed: https://api.github.com/repos/colonyos/colonies/releases/174527223","Warn: release artifact v1.8.15 not signed: https://api.github.com/repos/colonyos/colonies/releases/174517399","Warn: release artifact v1.8.14 not signed: https://api.github.com/repos/colonyos/colonies/releases/174418909","Warn: release artifact v1.8.18 does not have provenance: https://api.github.com/repos/colonyos/colonies/releases/199481590","Warn: release artifact v1.8.17 does not have provenance: https://api.github.com/repos/colonyos/colonies/releases/175078602","Warn: release artifact v1.8.16 does not have provenance: https://api.github.com/repos/colonyos/colonies/releases/174527223","Warn: release artifact v1.8.15 does not have provenance: https://api.github.com/repos/colonyos/colonies/releases/174517399","Warn: release artifact v1.8.14 does not have provenance: https://api.github.com/repos/colonyos/colonies/releases/174418909"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/docker_master.yaml:14"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Pinned-Dependencies","score":3,"reason":"dependency not pinned by hash detected -- score normalized to 3","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docker_master.yaml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/colonyos/colonies/docker_master.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docker_master.yaml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/colonyos/colonies/docker_master.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/go.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/colonyos/colonies/go.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/go.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/colonyos/colonies/go.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/releaser.yaml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/colonyos/colonies/releaser.yaml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/releaser.yaml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/colonyos/colonies/releaser.yaml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/releaser.yaml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/colonyos/colonies/releaser.yaml/main?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating alpine to alpine@sha256:4bcff63911fcb4448bd4fdacec207030997caf25e9bea4045fa6c8c44de311d1","Warn: containerImage not pinned by hash: buildtools/Dockerfile.build_ubuntu_2020:1: pin your Docker image by updating ubuntu:20.04 to ubuntu:20.04@sha256:8feb4d8ca5354def3d8fce243717141ce31e2c428701f6682bd2fafe15388214","Warn: goCommand not pinned by hash: vendor/github.com/json-iterator/go/build.sh:10","Warn: goCommand not pinned by hash: vendor/google.golang.org/grpc/regenerate.sh:35","Warn: goCommand not pinned by hash: vendor/google.golang.org/grpc/vet.sh:37","Info:   0 out of   6 GitHub-owned GitHubAction dependencies pinned","Info:   3 out of   4 third-party GitHubAction dependencies pinned","Info:   0 out of   2 containerImage dependencies pinned","Info:   1 out of   4 goCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Vulnerabilities","score":0,"reason":"13 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GO-2024-2955 / GHSA-869c-j7wc-8jqv","Warn: Project is vulnerable to: GO-2024-3250 / GHSA-29wx-vh33-7x7r","Warn: Project is vulnerable to: GO-2025-3553 / GHSA-mh63-6h87-95cp","Warn: Project is vulnerable to: GO-2024-3218","Warn: Project is vulnerable to: GO-2024-2682 / GHSA-c33x-xqrf-c478","Warn: Project is vulnerable to: GO-2024-3302 / GHSA-px8v-pp82-rcvr","Warn: Project is vulnerable to: GO-2024-3321 / GHSA-v778-237x-gjrc","Warn: Project is vulnerable to: GO-2025-3487 / GHSA-hcg3-q754-cr77","Warn: Project is vulnerable to: GO-2024-2687 / GHSA-4v7x-pqxf-cx7m","Warn: Project is vulnerable to: GO-2024-3333","Warn: Project is vulnerable to: GO-2025-3503 / GHSA-qxp5-gwg8-xv66","Warn: Project is vulnerable to: GO-2025-3595 / GHSA-vvgc-356p-c3xw","Warn: Project is vulnerable to: GO-2024-2611 / GHSA-8r3f-844c-mc37"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-17T20:26:11.195Z","repository_id":38523912,"created_at":"2025-08-17T20:26:11.195Z","updated_at":"2025-08-17T20:26:11.195Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28827900,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T23:29:49.665Z","status":"ssl_error","status_checked_at":"2026-01-27T23:25:58.379Z","response_time":168,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cryptography","distributed-systems","faas","faas-framework","kubernetes","operating-system","orchestration","zero-trust-security"],"created_at":"2025-12-28T01:39:10.753Z","updated_at":"2026-01-27T23:41:44.143Z","avatar_url":"https://github.com/colonyos.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![codecov](https://codecov.io/gh/colonyos/colonies/graph/badge.svg)](https://codecov.io/gh/colonyos/colonies)\n[![Go](https://github.com/colonyos/colonies/actions/workflows/go.yml/badge.svg)](https://github.com/colonyos/colonies/actions/workflows/go.yml)\n\n![ColonyOSLogo](docs/images/ColonyOsLogoNoShaddow2.png)\n\n# ColonyOS - Distributed Meta-Orchestrator\n\nColonyOS is an open-source framework for seamless execution of computational workloads across heterogeneous platforms - cloud, edge, HPC, IoT devices, and beyond. It creates **Compute Continuums** by providing a unified orchestration layer that operates as a meta-orchestrator on top of existing infrastructure.\n\n## Why ColonyOS?\n\nTraditional orchestration systems are tied to specific platforms (Kubernetes for cloud, Slurm for HPC, etc.). ColonyOS breaks these silos through **meta-process management** - a broker-based architecture that separates computational intent from execution.\n\nExample of use cases:\n\n- **Scientific Computing**: Process satellite imagery, analyze sensor data, run simulations across HPC clusters\n- **AI/ML Pipelines**: Distribute training jobs, run inference on edge devices, orchestrate multi-agent LLM systems\n- **Serverless at Scale**: Build FaaS platforms that span cloud, edge, and on-premise infrastructure\n- **Data Processing**: ETL pipelines, batch processing, real-time stream processing with ColonyFS integration\n- **Industrial IoT**: Coordinate computations across factory floor devices, edge gateways, and cloud\n- **Earth Observation**: Automated satellite image processing and analysis workflows\n- **Infrastructure as Code**: Declaratively manage infrastructure across computing continuums - define services spanning cloud, edge, HPC, and IoT with GitOps workflows, automatic drift detection, and self-healing reconciliation\n\n### The Core Idea\n\n**Declarative Intent + Broker + Distributed Execution = Computing Continuums**\n\nInstead of writing platform-specific code, you declare **WHAT** you want to compute using Function Specifications. The Colonies Server acts as a **broker** that matches your intent with available **Executors** (distributed workers) that know **HOW** to execute on their specific platforms. This separation creates seamless **Computing Continuums** across heterogeneous infrastructure.\n\n### Key Advantages\n\n- **Platform Agnostic**: Same function specification runs on Kubernetes, HPC, edge devices, IoT - executors translate to platform-specific execution\n- **Decoupled Architecture**: Submit work anytime, execute asynchronously - temporal and spatial decoupling via broker\n- **Zero-Trust by Design**: No session tokens, no passwords - every request cryptographically signed with Ed25519\n- **Protocol Flexibility**: HTTP/REST API with WebSocket support for real-time communication\n- **Pull-Based Execution**: Executors connect from anywhere (even behind NAT/firewalls) and pull work - no need for inbound access\n- **Built-in Audit Trail**: Every execution recorded as an immutable ledger for compliance and debugging\n- **Real-Time Reactive**: WebSocket subscriptions for instant notifications on workflow state changes\n\n## Key Features\n\n- **HTTP/REST Architecture**: Clean REST API with WebSocket support for real-time subscriptions\n- **Distributed Execution**: Executors run anywhere on the Internet - supercomputers, edge devices, browsers, embedded systems\n- **Zero-Trust Security**: All communication cryptographically signed with Ed25519\n- **Workflow DAGs**: Complex computational pipelines with parent-child dependencies\n- **Event-Driven**: Real-time WebSocket subscriptions for process state changes\n- **Scheduled Execution**: Cron-based and interval-based job scheduling\n- **Dynamic Batching**: Generators that pack arguments and trigger workflows based on counter or timeout conditions\n- **Service Reconciliation**: Kubernetes-style declarative service management with automatic drift detection and correction\n- **Full Audit Trail**: Complete execution history stored as an immutable ledger\n- **High Availability**: Etcd-based clustering with automatic failover\n- **Multi-Language SDKs**: Go, Rust, Python, Julia, JavaScript, Haskell\n\n## Architecture\n\n### Core Concepts\n\n- **Colony**: A distributed runtime environment - a network of loosely connected Executors\n- **Executor**: Distributed worker that pulls and executes workloads (can be implemented in any language, runs anywhere)\n- **Process**: Computational workload with states: WAITING → RUNNING → SUCCESS/FAILED\n- **FunctionSpec**: Specification defining what computation to run and execution conditions\n- **ProcessGraph**: Workflow represented as a Directed Acyclic Graph (DAG)\n- **Service**: Declarative infrastructure specification with desired state management\n- **Reconciliation**: Automatic drift detection and correction that maintains services in their desired state\n\n### How It Works\n\n1. **Submit**: Users submit function specifications to the Colonies server\n2. **Schedule**: The scheduler assigns processes to available Executors based on conditions\n3. **Execute**: Executors pull assigned processes, execute them, and report results\n4. **Chain**: Complex workflows span multiple platforms by chaining processes together\n5. **Monitor**: Real-time subscriptions and full execution history enable observability\n\n![MetaOS](docs/images/arch.png)\n\n### Zero-Trust Security Model\n\nColonies implements a **zero-trust architecture** where all communication is cryptographically signed:\n- No traditional authentication tokens or session management\n- Each request signed with Ed25519 private keys\n- Server validates signatures and enforces role-based access control\n- Executors can operate on untrusted infrastructure while maintaining security\n\n### Server Configuration\n\nThe Colonies server exposes an HTTP/REST API with WebSocket support:\n\n```bash\nexport COLONIES_SERVER_HOST=\"0.0.0.0\"\nexport COLONIES_SERVER_PORT=\"50080\"\nexport COLONIES_TLS=\"false\"\n```\n\n## Tutorials\n\nComprehensive step-by-step tutorials are available in the [tutorials repository](https://github.com/colonyos/tutorials):\n\n## Dashboard\n\nThe [Colonies Dashboard](https://github.com/colonyos/dashboard) provides a web UI for monitoring and managing your compute continuum:\n\n![Dashboard](docs/images/dashboard1.png)\n![Dashboard](docs/images/dashboard2.png)\n![Dashboard](docs/images/dashboard3.png)\n\n## Documentation\n\n### Getting Started\n- [Installation Guide](docs/Installation.md) - Install and configure Colonies\n- [Getting Started](docs/GettingStarted.md) - Your first Colonies application\n- [Configuration](docs/Configuration.md) - Environment variables and settings\n\n### Guides\n- [Introduction](docs/Introduction.md) - Core concepts and architecture\n- [Implementing Executors](docs/Executor.md) - Create executors in Python, Go, Julia, JavaScript\n- [Fibonacci Tutorial (Go)](docs/GoTutorial.md) - Complete example application\n- [Workflow DAGs](docs/Workflows.md) - Create complex computational pipelines\n- [Generators](docs/Generators.md) - Batch processing and dynamic workflows\n- [Cron Jobs](docs/Crons.md) - Schedule recurring tasks\n- [CLI Usage](docs/CLI.md) - Command-line interface reference\n- [Logging](docs/Logging.md) - Process logging and monitoring\n\n### Architecture \u0026 Design\n- [Overall Design](docs/Design.md) - System architecture and design patterns\n- [RPC Protocol](docs/RPC.md) - HTTP RPC protocol specification\n- [Security Design](docs/Security.md) - Zero-trust security model\n\n### Deployment\n- [Container Building](docs/ContainerBuilding.md) - Build Docker containers for single and multi-platform\n- [High-Availability Deployment](docs/HADeployment.md) - Production cluster setup\n- [Monitoring](docs/Monitoring.md) - Grafana and Prometheus integration\n- [Kubernetes Helm Charts](https://github.com/colonyos/helm) - Deploy on Kubernetes\n\n### SDKs \u0026 Tools\n- [Go SDK](https://github.com/colonyos/colonies/tree/main/pkg/client) - Official Go client library\n- [Python SDK](https://github.com/colonyos/pycolonies) - Python client library\n- [Rust SDK](https://github.com/colonyos/rust) - Rust client library\n- [Julia SDK](https://github.com/colonyos/Colonies.jl) - Julia client library\n- [JavaScript SDK](https://github.com/colonyos/colonies.js) - JavaScript/Node.js library\n- [Haskell SDK](https://github.com/colonyos/haskell) - Haskell client library\n- [Executors](https://github.com/colonyos/executors) - Pre-built executor implementations\n\n## Development\nThe repository contains a development container configuration to simplify development environment setup. You can use it locally or in a [GitHub Codespace](https://docs.github.com/en/codespaces). The configuration will launch a TimescaleDB-insance for the ColonyOS database, a MinIO instance for the ColonyOS file system and the actual development container. It will automatically generate required credentials and keys unique to your environment, no furhter configuration needed. \n\n**Local Development (VS Code):**\n\n1. Install Docker on your machine.\n2. Install the Dev Containers extension in Visual Studio Code.\n3. Clone this repository.\n4. Open the folder in Visual Studio Code.\n5. When prompted, select \"Reopen in Container\" or use the command \"Dev Containers: Open Folder In Container...\" from the command palette.\n\n**GitHub Codespaces:**\n\n- Simply create a Codespace from the repository page on GitHub. The development container will be set up automatically.\n\n### Building\n\n```bash\nmake build              # Build the main colonies binary\nmake container          # Build Docker container for local architecture\nmake container-multiplatform  # Build for amd64 and arm64\nmake install            # Install to /usr/local/bin\n```\n\nFor detailed instructions on building containers including multi-platform builds, see the [Container Building Guide](docs/ContainerBuilding.md).\n\n### Testing\n\n```bash\nmake test              # Run all tests\nmake github_test       # Run tests for CI (no color output)\n```\n\n### Code Coverage\n\n```bash\nmake coverage         # Generate coverage reports\n```\n\n## Production Usage\n\nColonyOS is currently used in production by:\n\n- **[RockSigma AB](https://www.rocksigma.com)** - Automatic seismic processing engine for underground mines, orchestrating workloads across cloud and edge infrastructure\n\n## Contributing\n\nContributions are welcome! Please see our contributing guidelines and code of conduct.\n\n## Community\n\n- Website: [colonyos.io](https://colonyos.io)\n- GitHub: [github.com/colonyos](https://github.com/colonyos)\n- Tutorials: [github.com/colonyos/tutorials](https://github.com/colonyos/tutorials)\n\n## License\n\nSee LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolonyos%2Fcolonies","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcolonyos%2Fcolonies","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolonyos%2Fcolonies/lists"}