{"id":26189793,"url":"https://github.com/evolutionary-algorithms-on-click/runner","last_synced_at":"2026-04-28T04:02:44.139Z","repository":{"id":280691992,"uuid":"942760636","full_name":"Evolutionary-Algorithms-On-Click/runner","owner":"Evolutionary-Algorithms-On-Click","description":"Algo Run Scheduler x RabbitMQ.","archived":false,"fork":false,"pushed_at":"2025-11-28T11:00:36.000Z","size":63,"stargazers_count":1,"open_issues_count":3,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-27T13:16:11.861Z","etag":null,"topics":["cockroachdb","docker","docker-compose","hacktoberfest","python","rabbitmq"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Evolutionary-Algorithms-On-Click.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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":"2025-03-04T16:22:38.000Z","updated_at":"2025-10-31T17:13:26.000Z","dependencies_parsed_at":"2025-03-19T15:22:27.965Z","dependency_job_id":"fa32b121-e208-45ab-a592-e5c97531b7db","html_url":"https://github.com/Evolutionary-Algorithms-On-Click/runner","commit_stats":null,"previous_names":["evolutionary-algorithms-on-click/runner"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/Evolutionary-Algorithms-On-Click/runner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evolutionary-Algorithms-On-Click%2Frunner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evolutionary-Algorithms-On-Click%2Frunner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evolutionary-Algorithms-On-Click%2Frunner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evolutionary-Algorithms-On-Click%2Frunner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Evolutionary-Algorithms-On-Click","download_url":"https://codeload.github.com/Evolutionary-Algorithms-On-Click/runner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Evolutionary-Algorithms-On-Click%2Frunner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32365519,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"online","status_checked_at":"2026-04-28T02:00:07.250Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cockroachdb","docker","docker-compose","hacktoberfest","python","rabbitmq"],"created_at":"2025-03-12T00:51:10.583Z","updated_at":"2026-04-28T04:02:44.129Z","avatar_url":"https://github.com/Evolutionary-Algorithms-On-Click.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Runner Service\n\nThe **Runner** service is a core component responsible for executing evolutionary algorithms. This guide explains how to set up and run the runner service locally using Docker, integrated with the rest of the operational stack.\n\n## Prerequisites\n\nBefore running the runner, you must have the full operations stack up and running. This includes databases, authentication, and other microservices.\n\n1.  **Clone the Operations Repository**:\n    ```bash\n    git clone https://github.com/Evolutionary-Algorithms-On-Click/operations.git\n    ```\n\n2.  **Follow the Docker Setup Instructions**:\n    Navigate to the `operations/docker` directory and follow the [README instructions](https://github.com/Evolutionary-Algorithms-On-Click/operations/tree/main/docker) to start all services.\n    \n    Ensure you run:\n    ```bash\n    docker compose up -d\n    ```\n    This will start all containers, including a pre-built version of the runner.\n\n## Running the Local Runner\n\nTo develop or test changes in the runner repository, you need to replace the pre-built runner container with your local code.\n\n### Step 1: Stop the Existing Runner\n\nSince the `operations` docker-compose starts a `runner` container, you must stop it to avoid port conflicts and ensure your local version connects instead.\n\n```bash\ndocker stop runner\n```\n\n### Step 2: Configure Environment\n\nThe `docker-compose.yml` in this repository is pre-configured to connect to the services running from the `operations` stack (using `host.docker.internal` for cross-container communication).\n\n**Key Environment Variables:**\n*   `COCKROACHDB_URL`, `REDIS_URL`: Connect to databases via host networking.\n*   `MINIO_URL`: Connects to the object storage.\n*   `WEBSOCKET_LOG_URL`: For real-time logging.\n\nEnsure your local `.env` or the default values in `docker-compose.yml` match the credentials set in your `operations` setup (e.g., `MINIO_ACCESS_KEY`, `MINIO_SECRET_KEY`).\n\n### Step 3: Start the Runner\n\nRun the runner using the localized `docker-compose.yml`. This builds the image from your current source code.\n\n```bash\n# Build and start the runner\ndocker compose up --build\n```\n\nYou should see logs indicating the runner is starting and connecting to Redis/CockroachDB.\n\n## Architecture\n\nThe following diagram illustrates how the Runner interacts with other operational services:\n\n```mermaid\ngraph TD\n    subgraph Operations Stack\n        DB[(CockroachDB)]\n        Redis[(Redis)]\n        MinIO[(MinIO)]\n        Auth[Auth Service]\n        Controller[Runner Controller]\n    end\n\n    subgraph Local Development\n        Runner[Runner Service]\n    end\n\n    Runner --\u003e|Fetch Tasks| Redis\n    Runner --\u003e|Store Results| DB\n    Runner --\u003e|Load/Save Artifacts| MinIO\n    Runner -.-\u003e|Report Status| Controller\n\n    style Runner fill:#f9f,stroke:#333,stroke-width:2px\n    style Operations Stack fill:#e1f5fe,stroke:#01579b\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevolutionary-algorithms-on-click%2Frunner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevolutionary-algorithms-on-click%2Frunner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevolutionary-algorithms-on-click%2Frunner/lists"}