accuclass-client

An unofficial Python client and command-line tool for the AccuClass attendance system. It uses AccuClass's legacy "Service" API, so you can pull attendance exports and records without .NET, Visual Studio or Engineerica's Windows tools. It uses only Python's standard library, so it has no dependencies.

Not affiliated with Engineerica. AccuClass is a product of Engineerica Systems, Inc. This project isn't affiliated with or endorsed by them. Only use it with an AccuClass account you're authorised to use, and within your institution's agreement with Engineerica.

Install

pip install accuclass-client

Requires Python 3.9 or later. This installs the accuclass command and the accuclass_client Python module.

If Windows says accuclass isn't recognised, Python's Scripts folder isn't on your PATH. That's common with the Microsoft Store version of Python. Use python -m accuclass_client instead, e.g. python -m accuclass_client probe.

Quick start

accuclass probe
accuclass export --type attendance --format CSV --out attendance.csv

probe logs in and shows a sample of your data, which confirms the connection works. You'll be asked for anything that isn't already set:

Exports need an account with export rights, usually an administrator.

About the User-Agent: accuclass.net is behind Cloudflare, which blocks Python's built-in User-Agent (Python-urllib/3.x) with HTTP 403 … error code: 1010. The client therefore sends a desktop browser's User-Agent by default, since that's the value proven in live use. Set ACCUCLASS_USER_AGENT to send something else.

Commands

The commands and helpers are limited to what's been confirmed on a live server. Some actions in Engineerica's original .NET client no longer exist on current servers: attendancelog.listsummary, for example, now returns "not registered in the service". Anything else can still be tried with raw or AccuClass.call().

Add -v to print each request as it's sent (passwords are masked). accuclass --version shows the installed version.

Python

from accuclass_client import AccuClass

with AccuClass() as ac:                                   # logs out automatically
    ac.login("yourdomain", "you@example.edu", "password")
    classes = ac.classes()                                # every class, paged automatically
    data = ac.export("attendance", "CSV")                 # bytes, exactly as the server produced them
    page = ac.call("class.list", **{"from": 0, "count": 50})   # any action, called directly

ac.call(action, **params) reaches any action of the API. Parameters set to None are left out; pass accuclass_client.JSON_NULL to send an explicit null. Failures raise AccuClassError.

How it works

Every call is a single HTTP request:

POST https://www.accuclass.net/Service/?action=<action>&token=<session token>
body: the parameters as a compact JSON object

login returns the session token. Exports run as background jobs: the client polls bgjob.getstatus and then downloads the finished file from JobResults/.

This mirrors Engineerica's own .NET client, EngineericaApi.dll, whose source they published in engineerica/engineerica-dev. The test suite checks that our requests are byte-for-byte identical to those the .NET client sends.

Status

This is an early release (alpha). So far it has been used against one institution's live AccuClass server for logging in, the attendance export, and listing classes and semesters. The automated tests run offline against a mock server. Reports of what works on your server are very welcome. Please open an issue.

Troubleshooting

Development

python -m unittest discover -s tests -v

The tests run offline against a local mock server. See CHANGELOG.md for version history.

Licence

MIT © 2026 Oliver Holdsworth