coleam00/Archon

The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.

View on GitHub ↗Jump to charts ↓Open shareable report →

Data as of . Signed-in members get hourly updates — create a free account.

Summary Information

Updated 37 minutes ago
Added to GitGenius on October 19th, 2025
Created on February 7th, 2025
Open Issues & Pull Requests: 251 (+0)
GitHub issues: Enabled
Number of forks: 3,493
Total Stargazers: 23,658 (+0)
Total Subscribers: 220 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 15.3 hours
Mean response time: 13.3 days
90th percentile: 46.3 days
Tracked items: 1,624

How this project is maintained

About 7% of issues opened in the past year have never received a reply. Only 16% of open issues come from outside the core team — the tracker reads mainly as internal planning. Work labelled "enhancement" is answered fastest, typically in about 6 hours, while "feature-request" waits about 12 days. Almost all tracked open issues have seen activity in the last three months. 83% of issues opened in the past year have been closed, leaving a working backlog.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 241
New in 7 days: 183
Closed in 7 days: 255
Avg open age: 19 days
Stale 30+ days: 87
Stale 90+ days: 5

Recent activity

Opened in 7 days: 173
Closed in 7 days: 241
Comments in 7 days: 90
Events in 7 days: 219

Top labels

  • bug (478)
  • area: workflows (292)
  • P2 (141)
  • effort/low (134)
  • effort/medium (116)
  • feature-request (99)
  • P1 (95)
  • feature (95)

Most active issues this week

Sign in to see which issues are moving.
Sign in

Detailed Description

Archon is presented as a sophisticated, distributed, fault-tolerant, and scalable job scheduler designed to manage and execute tasks across a cluster of machines. Its primary objective is to provide a robust and reliable platform for automating batch processes, long-running services, and complex workflows, ensuring that jobs are completed even in the face of node failures. The system aims to be a powerful yet approachable alternative to more heavyweight cluster management solutions, offering a compelling balance of features and operational simplicity for orchestrating critical tasks.

At its core, Archon employs a master-worker architecture, where a set of master nodes form a highly available control plane, and worker nodes are responsible for executing the actual jobs. The fault tolerance and state consistency of the master cluster are achieved through the implementation of the Raft consensus algorithm. This ensures that the system can withstand the failure of individual master nodes without losing critical state information or interrupting scheduling operations, as a new leader can be elected seamlessly. Job definitions, execution history, and system state are persistently stored, typically in a PostgreSQL database, providing durability and recoverability.

Users interact with Archon primarily through a comprehensive RESTful API and an intuitive web-based user interface. These interfaces allow for the submission, monitoring, and management of jobs, offering insights into their status, resource consumption, and execution logs. Archon supports a variety of job types, including simple shell commands, script execution, and crucially, containerized workloads via Docker. This flexibility enables users to define jobs that leverage isolated environments, ensuring consistent execution across different worker nodes and simplifying dependency management.

The scheduling mechanism within Archon is intelligent and resource-aware. It considers factors such as available CPU, memory, and network resources on worker nodes before dispatching jobs, aiming to optimize resource utilization and prevent overloading. Jobs can be configured with various parameters, including recurrence schedules (like cron jobs), dependencies on other jobs, and retry policies, allowing for the construction of complex, resilient workflows. When a job is dispatched to a worker, the worker executes the task and reports its status back to the master, which updates the central state and logs the outcome.

Beyond basic job execution, Archon incorporates features vital for production environments. It provides detailed logging and metrics, enabling administrators to monitor cluster health, job performance, and identify potential bottlenecks. The system's design emphasizes scalability, allowing new worker nodes to be added to the cluster to increase processing capacity as demand grows. The use of Go for its core services contributes to its performance and efficiency, while React powers the responsive and modern user interface. In summary, Archon stands out as a well-engineered solution for distributed job scheduling, combining the reliability of Raft for consensus, the flexibility of containerized job execution, and a user-friendly interface to offer a robust platform for automating critical tasks.