Skip to content

Releases

ArchSim 1.2.0

Choose a tag to compare

@dante0747 dante0747 released this 16 Nov 17:49

A privacy notice for hosted servers, pages that claim only what is true, and working API docs. Simulation results do not change: the engine's version (1.1.1) does not move.

Try it live: app.archsim.io · Docs and accuracy report: archsim.io

Added

  • A privacy notice for a hosted server. Set ARCHSIM_PRIVACY_URL and the app links "Privacy" from its home page and sign-in page (Hosting a public server › Privacy).
  • The demo's privacy notice at archsim.io/privacy/: who runs app.archsim.io and where, what it stores and for how long, its cookies and logs, and how to have your data deleted.

Fixed

  • API docs: /api/v1/docs names the ArchSim API at ArchSim's version, and "Try it out" calls the page's own origin instead of an address inside the deployment.
  • Hosted wording: a hosted server's home page no longer says ArchSim "runs on your machine"; it offers trying it there or running your own with one command.
  • Guests on a phone get the design's JSON to take to a computer, not a link that only opens in the sandbox's own browser.
  • Accuracy page: it says every run was measured on one laptop under Docker Desktop and that the benchmarks rerun by hand (the weekly and release runs stay off until a run passes on Linux).
  • Smaller things: run pickers name each run's short id; sandboxes show their project cap ("4 of 5"); a sandbox's end names your time zone; the browser tab names the open project; findings say "1 request failed"; the landing page's figures come from a real run the engine's tests keep current.

Upgrade

git pull && docker compose pull && docker compose up -d

On a server running the hosting kit: deploy/update.sh v1.2.0, and optionally set ARCHSIM_PRIVACY_URL in hosted.env.

Images: ghcr.io/dante0747/archsim-app:1.2.0 and ghcr.io/dante0747/archsim-web:1.2.0, for linux/amd64 and linux/arm64. Full changelog: v1.1.0...v1.2.0.

ArchSim 1.1.0

Choose a tag to compare

@dante0747 dante0747 released this 16 Nov 12:15

Host ArchSim on a public server of your own, and let visitors try it there without an account.

Try it live: app.archsim.io · Docs and accuracy report: archsim.io

Added

  • A kit for hosting a public server, in deploy/: the release's images with sign-in, behind either Caddy (HTTPS with certificates it renews itself) or a Cloudflare Tunnel (no open ports); a nightly database backup; and run limits for a public demo. It runs on any server with Docker from 2 cores and 4 GB, amd64 or arm64. Hosting a public server goes from an empty server to a running site, and from one release to the next (ADR-0080).
  • Try it without signing in. With ARCHSIM_SANDBOXES=true on a hosted server, the sign-in page offers a sandbox for 24 hours with no account: small runs, five projects, deleted with everything in it when it expires. Starts are limited per address and to 500 at once; guests make no team workspaces, API tokens, invitations or share links (ADR-0079).

Changed

  • The database gains its second migration (V2: users.expires_at); the migrate service applies it before the API and workers of this release start.
  • The accuracy page links the files it names to the repository on GitHub.

Fixed

  • On a phone, the home page's feature grid fits the screen instead of cutting its tiles' right edges.

Upgrade

git pull && docker compose pull && docker compose up -d

On a server running the hosting kit: deploy/update.sh v1.1.0.

Images: ghcr.io/dante0747/archsim-app:1.1.0 and ghcr.io/dante0747/archsim-web:1.1.0, for linux/amd64 and linux/arm64. Full changelog: v1.0.0...v1.1.0.

ArchSim 1.0.0

Choose a tag to compare

@dante0747 dante0747 released this 15 Nov 22:36

Run it with nothing but Docker:

git clone https://github.com/dante0747/archsim.git
cd archsim
docker compose up

Then open http://localhost:3000, choose Open the starter example and press Simulate. The images are ghcr.io/dante0747/archsim-app:1.0.0 and ghcr.io/dante0747/archsim-web:1.0.0, for amd64 and arm64.

The first public release. ArchSim predicts how a system design behaves under load, failures and cost, and publishes how accurate it is. Start with Getting started.

Highlights

  • A studio for distributed systems. Four workspaces around one canvas (Design, Test, Results and a Dashboard) and one Simulate button. 25 ready-made templates, from a cache-aside starter to Kafka pipelines, Cassandra quorums and serverless bursts.
  • Real technology behaviour. PostgreSQL, MySQL, SQL Server, MongoDB, Cassandra, DynamoDB-style stores, Elasticsearch, Redis, Valkey, Memcached, Kafka, RabbitMQ, SQS-style queues, Nginx, Envoy, Kong, Kubernetes, serverless functions and third-party APIs, each with the behaviour its documentation describes and a link to it. A core set is ArchSim's focus; the rest is marked experimental.
  • A deterministic Java engine. A discrete-event simulator on Java 25 moves every request through every hop, queue, lock and retry. The same document and seed give the same result digest in the web app, the API, the CLI and the MCP server.
  • A straight answer. A verdict against your objectives, the bottleneck, what to fix first, the breaking point and the monthly cost on real AWS instance types.
  • Published accuracy. docs/validation.md checks predictions made before measuring against nine experiments on real services, misses included.
  • One command to run it. docker compose up starts the whole stack from ArchSim's release images, for amd64 and arm64, with nothing but Docker installed.

Added

  • Design: a parts library with technology logos; mobile, web and API-consumer clients with their own timeouts, retries and traffic shares; CPU, memory and storage per part, auto-sized for the peak load when left empty; a design review for single points of failure, missing timeouts, retry amplification, timeout inversions and pool exhaustion.
  • Test: a test plan with traffic, objectives and failures (outages, slowdowns, link latency, spikes), chaos pads, and a second-by-second replay on the canvas and the timeline.
  • Results: the answer, a cost-against-latency comparison of every scenario, a breaking-point sweep, findings in plain language, the calculations behind each number, sampled request traces and a Markdown report.
  • Dashboard: Grafana-style panels with a synced crosshair, per-component signals, annotations and data inspection.
  • Calibration from Prometheus metrics or an OpenTelemetry trace export, with every fitted input marked measured and a replay of what was observed (docs/calibration.md).
  • Import from docker-compose, Kubernetes manifests or a Terraform plan, and export to docker-compose, Kubernetes manifests or Mermaid (docs/import.md).
  • Prices from an AWS us-east-1 on-demand snapshot: parts run on the cheapest real instance type that fits, and every cost line cites it (docs/pricing.md).
  • An SLO gate for CI: archsim check and a GitHub Action that comments on pull requests (docs/ci.md).
  • The archsim command line: validate, analyze, run, compare, calibrate, import, export, check, catalog and schema (archsim-cli).
  • AI agents: an MCP server over stdio for coding agents, and WebMCP tools in the web app for agents in the browser (docs/agents.md).
  • Teams (optional): GitHub and Google sign-in, personal and team workspaces with viewer, editor and owner roles, invitations, API tokens, rate limits, comments, sign-offs, a history of every change and read-only share links (docs/deployment.md).
  • Peak hours a month (schema 1.8). workload.peakHoursPerMonth says how many hours a month the traffic runs at its pattern's peak; the monthly cost bills those hours at the peak and the rest at the base load, line by line, and the cost per million requests counts both loads' requests; cost.peakHours reports the hours it billed. It defaults to 0 (the whole month at the base load), is left out of a document while 0, and is set in Design → Traffic for a burst, a ramp or a trace (ADR-0074).
  • ArchSim's own version, 1.0.0, kept apart from the engine's: archsim --version prints archsim 1.0.0, engine 1.1.1, GET /meta gives version beside engineVersion, and the MCP server's serverInfo.version is ArchSim's (ADR-0076).
  • Running it: a Docker Compose stack (PostgreSQL, migrations, the API, workers and the web app) from release images on GitHub's container registry, ghcr.io/dante0747/archsim-app and archsim-web, for amd64 and arm64; make up-local runs your own build instead (ADR-0077). Workers run on any number of machines, sharing a run queue in PostgreSQL.

Changed

  • The engine, the API, the CLI and the MCP server moved from Python to Java 25 (the port's plan). The Java engine 1.0.0 reproduces the frozen Python engine 0.16.0's recorded runs figure for figure (java-parity.md), about 14 times faster on the templates (docs/performance.md).
  • Cost of autoscaling (engine 1.1.0, report 1.16). An autoscaled service is billed at the replicas its autoscaler settles at for the base load's work, within minReplicas–maxReplicas, no longer at the run's average replicas scaled to the base load and floored at the count it starts with; a Kubernetes cluster with its autoscaler is billed the nodes its pods need there, and one without it its nodes. Beside the month, every cost prices an hour at the peak (cost.hourly), with each line's instances there (peakInstances) (ADR-0074, What a month is).
  • Black Friday's sale day. The Black Friday on Kubernetes template bills 24 peak hours a month, and a new scenario, "No autoscaling (14 fixed pods)", sizes the checkout for the peak all month: $843.63 a month with the HPA against $1,434.02 for 14 fixed pods. The templates hold 125 scenarios.
  • The accuracy benchmarks' harness and the repository's tools moved from Python to Java as well: archsim-benchmarks, run as ./gradlew :archsim-benchmarks:run --args="<command>", and archsim-tools (the commit-message check, CI's changed parts and the price refresh). Building ArchSim and contributing to it no longer need Python or uv (CONTRIBUTING.md). The one Python left is a benchmarked service, benchmarks/service-python, which builds in its own container.
  • ArchSim is licensed under the GNU AGPL-3.0-only, with a commercial license available from the copyright holder (ADR-0067).

Fixed

  • The base load's rates after a run (engine 1.1.1). When no time bucket of a run's window is at the base load (a ramp that passes it during the warm-up), the base's per-request rates come from the buckets nearest it, no longer from the whole window's mean scaled down, which the failures and timeouts at the peak moved. The peak's rates do the same when no bucket is at the peak. No template's monthly cost changes.
  • Labels on the Cost vs. speed map. A run's label no longer covers another run's marker or label, or the objective line's label: it moves to its point's other side, or a line down or up with a leader to its point. Runs drawn at one point share one label that names each.

Removed

  • The Python engine, its API and its MCP server. The tag engine-0.16.0 keeps the engine and the MCP server.
  • The SQLite development mode: the API needs PostgreSQL (ADR-0016).
  • Plugin entry points for third-party component models.
  • The Python benchmark harness and the repository's Python scripts. The tag cpython-recorders keeps them.
  • Breaking: the CLI's hidden archsim functions command, which answered the Python benchmark harness's calls into the engine. A script that called it now gets an unknown command (exit code 2); call the engine's classes in process instead, as archsim-benchmarks does ([ADR-0073](https://github.com/dante0747/archsim/blob/v1.0.0/docs/adr/0073-remove...
Read more