Menu

Theme

Help · Guide · CHECKED ON 5.0.0

Logisim course setup: versions, lab setup and automatic grading

For a new course, require Logisim-evolution 5.0.0 and link students to the installers, which include Java; pin the exact version, because files saved by newer versions do not open in older ones. Grade with test vectors on the command line, but read the Failed: 0 line, not the exit code, which was always 0 in our runs, and run it with a display (Xvfb on a server). Our circuits, test vectors and memory images are free to reuse under CC BY 4.0.
FOR
Instructors, TAs and lab administrators
CHECKED
12 Nov 2026
Checked against Logisim-evolution 5.0.0 on 6 machines
On this page

Which version to require

Show all paths
  1. Is this a new course? Yes → Require Logisim-evolution 5.0.0
  2. Is this a new course? No, I have existing material → Is it in classic 2.7.1 format? Yes → Test your files in 5.0.0 first
  3. Is this a new course? No, I have existing material → Is it in classic 2.7.1 format? No, it depends on a fork or a course jar → Keep it

Facts a teacher needs, each from our runs: files saved by 5.0.0 do not open in 2.7.1 (F04); the jar needs Java 21 while installers carry their own Java (F20, F27); 5.0.0 ran a counter benchmark about 3.5 times faster than 2.7.1 (F19). Upstream’s changelog also describes changes in how pins and RAM behave in newer versions; we did not test them, so check any circuit that relies on them.

What other courses require

We collected 34 course pages that mention Logisim. 18 of them state a version, and those name 10 different builds or tools; the other 16 do not say. Pages are snapshots of past terms, so follow your own course page. We pass no judgement on any course’s choice. Corrections are welcome (contact).

Courses that mention Logisim
UC BerkeleyCS61C Great Ideas in Computer ArchitectureCourse-distributed Logisim-evolution jar: "use the .jar file we have given you"source2026-11
CornellCS 3410 Computer System OrganizationA Cornell snapshot of Logisim Evolution from the course Resources pagesource2026-11
DukeECE/CS 250 Computer ArchitectureEvolution 2.15.0, "not a newer one"source2026-11
U Toronto MississaugaCSC258 Computer OrganizationEvolution 3.4.1 (-all.jar); "do NOT use the original Logisim"source2026-11
U Toronto ScarboroughCSCB58Logisim-evolution, version not stated in the reference PDFsource2026-11
NUSCS2100 Computer OrganisationNot stated on the pages we readsource2026-11
SwarthmoreCS31 Intro to Computer SystemsLogisim-ITAsource2026-11
NYUCSO Computer Systems OrganizationEvolution 2.15 (jar in the course repository)source2026-11
ShanghaiTechCS110 Computer Architecture ILogisim-evolution; one lab names 4.1.0 and Java 21source2026-11
UP Diliman (UP Microlab)EEE digital labsEvolution 3.8 jar ("use 3.8 if you cannot run 3.9")source2026-11
U ReginaCS201Classic 2.7.1 (logisim-win-2.7.1.exe)source2026-11
Washington and LeeSimon Levy courseClassic 2.7.1 generic jarsource2026-11
College of WoosterCS210Classic 2.7.1 jar (seen in a search snippet)source2026-11
Colorado StateCS270Classic 2.7.1 macOS tarballsource2026-11
Hobart and William SmithCPSC 220Version not statedsource2026-11
GrinnellCSC211 Computer OrganizationVersion not stated (page did not load for us)source2026-11
Harvey MuddCS42Classic (2012 handout, exact version not stated)source2026-11
PrincetonCOS 116Classic (archived 2011 lab, exact version not stated)source2026-11
UC DavisECS154ANot statedsource2026-11
University of FloridaEEL 3701Listed as a Logisim Evolution lab (page did not load for us)source2026-11
ClemsonECE 2090Logisim Evolution (links the release page)source2026-11
KFUPMCOE301 and ICS233Classic (tutorial era, exact version not stated)source2026-11
College of the Holy CrossCSCI 226Holy Cross Edition fork, jar named 5.0.4hcsource2026-11
Missouri S&TCpE 2211Not statedsource2026-11
WilliamsCS 237Not statedsource2026-11
METUCENG232Classic (2009 custom build)source2026-11
ITUBLG 231ENot statedsource2026-11
Manchester Metropolitan UniversityCampus softwareBoth 2.7.1 and Evolution are offeredsource2026-11
University of MilanComputer Architecture INot statedsource2026-11
Brooklyn CollegeCS 3310Not statedsource2026-11
Bern University of Applied SciencesDigital design labsCurrent Evolution, with FPGA boardssource2026-11
Bielefeld UniversityBasys 3 labsA fork with Basys 3 supportsource2026-11
Huntington UniversityIT helpdeskNot statedsource2026-11
UNCCOMP 311This course uses Digital, not Logisimsource2026-11

Setting up lab computers and student laptops

On Windows

  • Use the MSI for the CPU type (x64 or ARM64). A silent install, msiexec /i logisim-evolution-5.0.0-amd64.msi /qn, succeeded in 4.2 s on a GitHub Windows Server 2025 runner, used 128.0 MB in C:\Program Files\logisim-evolution\, and added a Start-menu shortcut and a .circ association (F25). The MSI is not digitally signed, so students may see a warning.
  • Uninstalling leaves the preferences behind (F26); the --clear-prefs option clears them (we did not run it).
  • winget: winget install --id logisim-evolution.logisim-evolution -e installed the MSI and verified its hash in 10.2 s (F56). Chocolatey and Scoop install the jar, so those images also need Java 21 (F57).

On macOS

  • The app is not notarized, so every student meets a “Not Opened” dialog with no Open button (F29, F64). Give them the macOS page.
  • The Homebrew cask failed because it is disabled (F31).
  • The Intel DMG published as 5.0.0 contained a 5.1.0 development build in our runs (F30); say so if your course pins exactly 5.0.0.

On Linux

  • The .deb installs to /opt/logisim-evolution/ (F33); the RPM installed and ran on Fedora (F54).
  • apt install logisim gives classic 2.7.1 (F22); the Snap was version 3.8.0 with a GTK error (F53).
  • The Flathub package was 5.0.0 but may read and write only the home folder (F52).
  • The AUR binary package failed on a clean system because it needs unzip and declares an older Java (F55).

Chromebooks and tablets are the device mix that fails most often. The .deb installed in the Debian container that Chromebooks use (F59, not a physical Chromebook); otherwise see Logisim online and CircuitVerse. If your course uses an FPGA board, see the FPGA guide. We did not make a student install handout PDF.

Grading circuits automatically

  1. Ask students to label pins exactly as the assignment says and to set the main circuit (the .circ viewer can check a file).
  2. Write a test vector per circuit (builder and checker).
  3. Run the grader script below per submission.
  4. Pin the Logisim and Java versions in the grader to the ones students use.
  5. For memory assignments, --load goes after the circuit and is ignored by a plain --tty table run without a halt pin (F16, F13).
Terminal (Linux grader)
./autograde-logisim.sh logisim-evolution-5.0.0-all.jar main tests.txt student.circ
PASS Passed: 8, Failed: 0

Download autograde-logisim.sh and the example circuit with its passing vector. We ran the script on 30 student-style variants of that circuit: 10 passed (including some, such as an output pin turned into an input, that a strict grader would not want), 20 failed, and each run took about 1 second except 5 that opened a dialog and were stopped by the 30 second limit (F102). Details and the full recipe are in the test vector guide. Classic 2.7.1 has no test vectors, and its -tty table never ends without a halt pin (F05).

Free material you can use

We publish verified .circ reference designs (projects), test vectors, memory images and screenshots of our own machines under CC BY 4.0. Credit them as “logisim.dev, CC BY 4.0” followed by the address of the page. Every circuit has a sidecar file with the version and test that verified it. Logisim itself is GPL software by its developers; we do not redistribute it.

Using our designs without enabling copying

Our projects teach a method and give one reference design; we do not publish answers to a particular lab. Use ours as lecture demos and change the specification for graded work, such as different widths, opcodes or state encodings. Grade with hidden test vectors and ask for the design rationale. If you find an assignment’s exact solution on this site, tell us (contact).

Common student problems and where to send them

Symptom to page
Mac says Logisim-evolution is Not OpenedInstall on macOS
Java error on startJava requirements
Wire coloursWire colours
Oscillation apparentFix Oscillation apparent
Clock does not tickClock and simulation
File will not openThe .circ file
Autograder says label not foundTest vectors
At the start of term0 / 5 done

Tell us about your course

To add or correct a course entry, use contact. See also how we test and the FAQ.

Frequently asked questions

Which Logisim version should a course use?

For a new course, Logisim-evolution 5.0.0. If your material is in 2.7.1 format, test your own files in 5.0.0 first: it opens them with a compatibility warning (F02), but 5.0.0 files do not open in 2.7.1 (F04).

Can students on 5.0.0 open files made in 2.7.1?

Yes, with a dialog titled Old file format, compatibility mode, and labels converted to VHDL-safe names (F02). We did not test a corpus of real course files.

How do I grade Logisim circuits automatically?

Run each submission with --test-vector under xvfb-run and decide from the Passed line, with a timeout. Our script passed a 30-file test (F102).

Why does the command-line test always return exit code 0?

In every run on 5.0.0 it did, even for failing vectors and unreadable files (F17, F102). The 5.0.0 code path ends without a failure code.

How do I install Logisim on lab computers silently?

On Windows, msiexec /i with /qn installed the MSI in 4.2 s on a GitHub runner (F25). On Linux install the .deb or RPM (F33, F54).

Can I use logisim.dev circuits in my course?

Yes. Our files are CC BY 4.0: credit logisim.dev and link the page. Do not hand our designs in as student work.

Sources

  1. Courses and institutions using Logisim, logisim.dev lab data: research/demand/user-problems.md §4, research/demand/courses-map.csv, src/content/courses.json
  2. Autograder run on 30 student-style files, logisim.dev lab data: test-data/lab17-2026-11-12-test-vectors/datasets/autograder.csv (F102)
  3. Installer, package and runtime facts, logisim.dev lab data: test-data/FINDINGS.md F19 to F34, F52 to F57

Try: , , ,