{"id":30212932,"url":"https://github.com/spcl/atlahs","last_synced_at":"2025-08-13T22:47:05.804Z","repository":{"id":308375252,"uuid":"982333505","full_name":"spcl/atlahs","owner":"spcl","description":"ATLAHS: An Application-centric Network Simulator Toolchain for AI, HPC, and Distributed Storage","archived":false,"fork":false,"pushed_at":"2025-08-05T14:55:54.000Z","size":92667,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-08-05T16:33:53.056Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spcl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-05-12T18:12:59.000Z","updated_at":"2025-08-05T15:30:47.000Z","dependencies_parsed_at":"2025-08-05T16:48:23.240Z","dependency_job_id":null,"html_url":"https://github.com/spcl/atlahs","commit_stats":null,"previous_names":["spcl/atlahs"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/spcl/atlahs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spcl%2Fatlahs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spcl%2Fatlahs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spcl%2Fatlahs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spcl%2Fatlahs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spcl","download_url":"https://codeload.github.com/spcl/atlahs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spcl%2Fatlahs/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270330450,"owners_count":24565796,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-13T02:00:09.904Z","response_time":66,"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":[],"created_at":"2025-08-13T22:47:02.629Z","updated_at":"2025-08-13T22:47:05.770Z","avatar_url":"https://github.com/spcl.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\nATLAHS Simulator Toolchain\n===================\nAn Application-centric Network Simulator Toolchain for AI, HPC, and Distributed Storage\n\n\u003cdiv align=\"left\"\u003e\n\n\n## Warning\nThis repository is still under active development. The code is not yet stable, and the documentation is not yet finalized.\nIt is highly recommended to start using the toolchain after the paper is published, and when the documentation is mostly complete.\n\n## Overview\n![Overview](docs/overview.png)\n\nThis repository contains the source code for ATLAHS, a network simulator toolchain for AI, HPC, and storage applications. It contains the following components:\n- GOAL (Group Operation Assembly Language) generators that traces AI, HPC, and storage applications and converts them into network workloads usable by network simulators\n- Various backends for simulating network workloads, including LogGOPSim, HTSim, and NS-3.\n\n\nThe paper of this work is available on arXiv: [https://arxiv.org/pdf/2505.08936](https://arxiv.org/pdf/2505.08936), and it has been accepted by The International Conference for High Performance Computing, Networking, Storage and Analysis (SC25).\n\nAlong with the source code, we also release all the traces (raw files and converted GOAL traces) used in the paper as the [ATLAHS Trace Collection](http://storage2.spcl.ethz.ch/traces/). Not only does it cover a wide range of AI and HPC applications, it is still growing, and we want to encourage the community to contribute more traces to the collection.\n\n### Docker Environment\nTo facilitate the reproducibility of the results which we publish in the paper, we provide a Docker image that contains all the dependencies that are required to run the ATLAHS toolchain.\n\nTo build the Docker image, run the following command:\n\n```bash\ndocker build -t atlahs .\n```\n\nTo compile the components required to reproduce the results in\nthe paper, run:\n```bash\ndocker run --user $(id -u):$(id -g) -v $(pwd):/workspace atlahs build -r\n```\nThis mounts the project directory to `/workspace` inside the con-\ntainer and invokes the build.py script in the scripts directory.\n\n\n#### Running a quick test\nTo run a quick test, run the following command:\n```bash\ndocker run --user $(id -u):$(id -g) -v $(pwd):/workspace atlahs run -q\n```\nThis fetches a small subset of the ATLAHS traces from the SPCL storage server,\nand tests the functionality of the ATLAHS toolchain. It converts the raw traces of\nAI (nsys-reports) and HPC (PMPI traces) applications into the [GOAL format](https://ieeexplore.ieee.org/document/5362477),\nand simulates the workloads with different backends (e.g., LogGOPSim, htsim) in ATLAHS.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspcl%2Fatlahs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspcl%2Fatlahs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspcl%2Fatlahs/lists"}