Skip to main content

AEMS Local Bridge Agent

As of v0.3.2 (2026-05-11), this package is licensed under AGPL-3.0-or-later (previously MIT). The agent links PyMuPDF in-process via aems-pdf-annotator, and AGPL applies to the combined work. See LICENSE for the full text.

A lightweight companion service that runs on localhost and provides REST API access to the local filesystem, enabling the AEMS hosted app to read/write exam PDFs to a user-chosen folder without ever uploading source PDFs to the server.

What it does

  • Runs as a local service on 127.0.0.1:61234 (default).
  • Exposes an authenticated REST API the AEMS web app uses to read source PDFs and write annotated PDFs from your local storage folder.
  • Enforces local Host headers and a PIN-based browser pairing flow before granting the web app access.
  • Optional system-tray icon so it's visible while running.
  • Optional offline grading bundle support for fully-local workflows.
  • Never sends PDF content out unless the user explicitly attaches a Canvas / offline workflow in the hosted app.

Installation

Pre-built installers — no Python needed — are on the Releases page.

Platform File Notes
Windows aems-agent-setup.exe Installs to %LOCALAPPDATA%\AEMS Agent
macOS AEMS-Agent.dmg Drag to Applications
Linux aems-agent-linux.tar.gz Extract and run ./aems-agent run

pip (for developers)

pip install aems-agent

Requires Python 3.10+.

Usage

# Print version and exit
aems-agent --version

# Start the agent (default: http://127.0.0.1:61234)
aems-agent run

# Start with system tray icon
aems-agent run --tray

# Custom port/host
aems-agent run --port 9000 --host 0.0.0.0

# Show auth token (the hosted app pairs against this token)
aems-agent token

# Set storage path
aems-agent set-path /path/to/exam/folder

# Show config directory
aems-agent config-dir

After aems-agent run, open AEMS in your browser, go to Settings → Storage, and pair the agent.

License

AGPL-3.0-or-later. See LICENSE.

Relicense note (v0.3.2, 2026-05-11): Versions ≤ 0.3.1 were licensed under MIT. From v0.3.2 the agent is AGPL-3.0-or-later because it links PyMuPDF (AGPL-3.0) in-process via aems-pdf-annotator. The MIT licence that previously applied to forks of v0.3.1 and earlier remains in effect for those versions.

Metadata

Release files for aems-agent 0.4.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aems-agent 0.4.6
File Size Uploaded Provenance Actions
aems_agent-0.4.6.tar.gz 117.5 kB Without provenance Details for aems_agent-0.4.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aems-agent 0.4.6
File Interpreter ABI Platform Actions
aems_agent-0.4.6-py3-none-any.whl Python 3 none any Details for aems_agent-0.4.6-py3-none-any.whl

Total release size: 189.9 kB

Release files / aems_agent-0.4.6.tar.gz

Download URL aems_agent-0.4.6.tar.gz
Size 117.5 kB
Tags Source
SHA-256 checksum
How to use checksums
092d808910dded84948d8eb76b07c49d87e66bd952f4b22ace11964d1751fafa
BLAKE2b-256 checksum
How to use checksums
ec0d721ceb2a5e06cb89974b5a14bf6bda402ab8b7feb6075ca7e4e2cfaa4f31
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.9

Release files / aems_agent-0.4.6-py3-none-any.whl

Download URL aems_agent-0.4.6-py3-none-any.whl
Size 72.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
74c3ec53de1e079f78dafd8db4ea76eb044d90aac680d970ffd95006bece82bd
BLAKE2b-256 checksum
How to use checksums
c426e25c5f514a26a9487116ad768f8b752d434ffbedd8d6a881cc744ef45091
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.9

Security for aems-agent 0.4.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page