Version 1.0.0 — Stable Release
Romanus is an open-source educational desktop application developed in Python using PySide6. It provides an interactive reference for exploring Greco-Roman languages, Roman numerals, mythology, and traditional astrology.
- Latin Alphabet: Explore the Latin alphabet and its reference information.
- Greek Alphabet: Browse Greek letters and their corresponding information.
- Roman Numerals: Study Roman numeral notation and convert between Roman and Arabic numerals.
- Greco-Roman Deities: Explore reference information about classical deities.
- Traditional Astrology: Browse zodiac signs and traditional planetary associations.
- Zodiac Explorer: Look up zodiac profiles using sign selection or calendar dates.
- Unified Search: Search across the application's reference datasets.
- Accessible Navigation: Use keyboard shortcuts, tooltips, and keyboard-focusable navigation controls.
- Python
- PySide6
- Qt Style Sheets (QSS)
- pytest
- pytest-qt
- PyInstaller
- Obtain the Romanus Windows distribution from the project's GitHub Releases page when published.
- Extract the distribution archive.
- Open the
Romanusfolder. - Double-click
Romanus.exe.
Keep the executable and its accompanying _internal directory together.
A separate Python installation is not required for the packaged application.
Clone the repository and navigate to the project directory.
Create a virtual environment:
python -m venv .venvActivate it:
.\.venv\Scripts\Activate.ps1Install dependencies:
python -m pip install -r requirements.txtLaunch Romanus:
python main.py| Shortcut | Action |
|---|---|
| Ctrl+F | Open Search |
| Ctrl+H | Open Home |
| Alt+Left | Return to Home |
Romanus uses pytest and pytest-qt for automated testing.
Run the complete test suite:
python -m pytest -vStable release verification: 179 automated tests passed, and final manual release checks were completed.
Romanus uses PyInstaller to generate its Windows distribution.
Build the application using:
python -m PyInstaller --clean --noconfirm Romanus.specThe packaged application is generated inside dist/Romanus/.
Additional documentation is available in the docs/ directory:
-
SRS.md— Software Requirements Specification -
SDD.md— Software Design Document -
CHANGELOG.md— Version history -
User Guide — Installation, features, and usage instructions.
| Version | Milestone |
|---|---|
| v0.1.0–v0.5.0 | Core reference features |
| v0.6.0 | Unified search |
| v0.7.0 | Zodiac Explorer |
| v0.8.0 | UI and accessibility improvements |
| v0.9.0 | Windows packaging |
| v1.0.0 | First stable release |
Future improvements may include additional reference content, interface refinements, and expanded educational functionality.
Romanus is licensed under the MIT License.
Copyright (c) 2026 Harrison Labrecque
See the LICENSE file for details.