Skip to content

Automated export control tracker for BIS policy changes and rule updates. Built for compliance and trade professionals.

Notifications You must be signed in to change notification settings

Hamiltonius/Regulus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Regulus β€” Export Control Tracker

Regulus is a streamlined Python tool designed to monitor and report changes in U.S. export control regulations. Tailored for compliance professionals, analysts, and policy teams, Regulus automates the tracking of federal register notices, extracts insights from source documents, and highlights new additions over time.

Current Build

The current stable version of Regulus is regulus.py.

This version includes ECCN extraction, PDF analysis, Excel summary output, and a dashboard with guidance tabs for export compliance professionals.

Older builds and experimental files are available in the archive/ folder.


Purpose

Export control compliance is critical for organizations working with dual-use technologies, semiconductors, and sensitive trade items. Regulus helps teams stay ahead by automating the monitoring of:

  • Bureau of Industry and Security (BIS) Federal Register notices
  • Export Administration Regulations (EAR) rule updates
  • ECCN classification changes
  • (Planned) OFAC sanctions and denied party list entries

Who It's For

  • Export compliance teams maintaining accurate, up-to-date documentation
  • Classification groups managing ECCN tracking and reporting
  • Audit/legal departments needing versioned compliance logs
  • Policy analysts following regulatory shifts in technology and trade

Key Features

  • Scrapes BIS Federal Register updates, with Selenium fallback for complex pages
  • Extracts text from PDFs linked in register entries
  • Applies regex-based parsing to detect:
    • Entity List additions
    • Final rule summaries
  • Compares current results against previous scans
  • Outputs:
    • Excel reports with tabbed summaries
    • Markdown reports highlighting new regulatory changes
  • Can be run manually or integrated into a scheduled cron job

Project Structure

regulus/
β”œβ”€β”€ scraper/
β”‚   β”œβ”€β”€ __init__.py                  # Module initializer
β”‚   β”œβ”€β”€ bis_scraper.py              # Static HTML scraper for BIS updates
β”‚   β”œβ”€β”€ bis_scraper2.py             # Secondary scraper (variant/test)
β”‚   β”œβ”€β”€ change_tracker.py           # Historical diffing & report generation
β”‚   β”œβ”€β”€ regulus1.2.py               # Archived v1.2 script
β”‚   β”œβ”€β”€ selenium_scraper.py         # Selenium-based fallback scraper
β”‚   └── utils.py                    # Helper functions
β”‚
β”‚   └── data/
β”‚       β”œβ”€β”€ pdfs/                   # Downloaded PDFs
β”‚       β”œβ”€β”€ processed/              # Excel summaries
β”‚       └── raw/                    # Raw CSV outputs
β”‚
β”œβ”€β”€ main.py                         # Optional entrypoint script
β”œβ”€β”€ regulus.py                      # Current production-ready script (v1.5)
β”œβ”€β”€ regulus_scraper.py             # Legacy file with redirect notice
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ README.md
β”œβ”€β”€ .gitignore
└── archive/                        # Archived builds and logs

About

Automated export control tracker for BIS policy changes and rule updates. Built for compliance and trade professionals.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages