Setup & Installation

Get Romasm running in your browser

No Installation Required!

Romasm runs entirely in your web browser. No downloads, no installation, no configuration needed!

Simply open any Romasm page in a modern web browser (Chrome, Firefox, Edge, Safari) and you're ready to go.

Running Locally

If you want to run Romasm from your local filesystem, you have a few options:

Option 1: Simple HTTP Server

Romasm requires an HTTP server (not just opening files directly) because it loads external JavaScript modules. Here are easy ways to run a local server:

Python (if installed):

# Python 3
python -m http.server 8000

# Python 2
python -m SimpleHTTPServer 8000

Then open http://localhost:8000 in your browser.

Node.js (if installed):

# Install http-server globally
npm install -g http-server

# Run it
http-server -p 8000

Then open http://localhost:8000 in your browser.

Using the Included Server:

If you have Node.js installed, you can use the included server:

node server.js

This will start a server (usually on port 3000 or 6969). Check the console output for the exact URL.

Browser Requirements

Romasm works in any modern web browser that supports:

  • ES6 JavaScript (ES2015+)
  • HTML5 Canvas API
  • Fetch API (for loading stdlib files)

Recommended browsers:

  • Chrome/Edge (latest)
  • Firefox (latest)
  • Safari (latest)

File Structure

If you're running Romasm locally, your file structure should look like:

romasm/
├── compiler/
│   ├── romasm-assembler.js
│   └── romasm-vm.js
├── stdlib/
│   ├── math.romasm
│   ├── trig.romasm
│   ├── calculus.romasm
│   └── ...
├── calcengine/
│   ├── romasm-calculator-engine.js
│   └── ...
├── linker/
│   └── romasm-linker.js
├── ide.html
├── romasm-calculator.html
└── ...

All files should be served from the same directory to ensure relative paths work correctly.

Troubleshooting

Error: "Failed to fetch" or CORS errors

Solution: You must run Romasm from an HTTP server, not by opening files directly (file://). Use one of the server options above.

Error: "Cannot find module" or 404 errors

Solution: Make sure all files are in the correct relative locations. Check the browser console for the exact file that's missing.

Functions not working (CALL sin, etc.)

Solution: Make sure the linker is enabled. In the calculator, it's automatic. In the IDE, you may need to manually enable stdlib linking.

Next Steps