ForgeASM is a configurable hardware architecture simulator for RISC-1, RISC-2, RISC-3, and CISC instruction sets.
Create and activate a virtual environment from the repository root:
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txtStart the API:
python -m uvicorn api.main:app --reloadIn a second terminal, start the frontend:
cd frontend
npm ci
npm run devOpen the URL printed by Vite, usually http://localhost:5173.
Run the Python tests from the repository root:
python -m pytest -qBuild the frontend:
cd frontend
npm run buildThe interactive API documentation is available at
http://127.0.0.1:8000/docs.
ForgeASM assembles source code, creates isolated simulation sessions, and supports stepping, running, resetting, memory inspection, trace inspection, and captured program output. It does not require an AI provider or external API key.
Apache-2.0. See LICENSE.