Skip to content
ElshayibPublic

About

Open-source local ExSim + NetSim practice platform for CCNA/CCNP

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

OpenBoson

An open-source, fully-local study platform that combines Boson ExSim-style practice exams and Boson NetSim-style guided labs / network simulator for Cisco certifications.

Shipped practice content targets CCNA 200-301 v1.1 and CCNP ENCOR 350-401 v1.2. Objective maps are taken from Cisco’s public exam topics (Learning Network / topics PDFs); registry refresh date: 2026-07-31 (see src/openboson/exsim/objectives.py).

Status

v0.4.1 Lab console polish is the last tagged release. master has Beat Boson core (teaching Check/review, honest NAT/DHCP/PortFast/EtherChannel labs, study loop, first-run). Next: PBQ/sim items and v1.0 signing — see docs/status.md.

OpenIOS is a teaching model, not full Cisco IOS — see docs/openios-vs-ios.md.

At a glance

  • Local-first — study data stays on your machine (PRIVACY.md); no accounts, no study telemetry

  • Windows installer — unsigned until v1.0 (SmartScreen expected; SUPPORT.md)

  • Original demo content only — no copyrighted exam dumps accepted

  • Download: GitHub Releases

  • Contributing: CONTRIBUTING.md · Conduct: CODE_OF_CONDUCT.md

  • Security: SECURITY.md · Privacy: PRIVACY.md · Support: SUPPORT.md

  • Developer handoff: docs/status.md · Agent guide: AGENTS.md

Architecture

OpenBoson is a single Python desktop application:

  • GUI: PySide6 (Qt for Python), with a modern dark-first theme.
  • Engine: Pure Python modules for question-bank parsing, exam sessions, lab grading, and simulation orchestration.
  • Persistence: SQLite in the user data directory.
  • Content format: YAML question banks and lab definitions; human-readable, diff-friendly, and local-first.
  • Optional HTTP layer: FastAPI/uvicorn for headless use and automated testing (localhost; no auth).

Quick start

# Install (editable)
pip install -e ".[all]"

# Run GUI
openboson gui

# Run engine server (optional, for headless use — keep on localhost)
openboson serve --port 0

License

MIT. See LICENSE.

Contributing

See CONTRIBUTING.md. Please open an issue before substantial changes. All content shipped with the repository is original demo material; we do not accept copyrighted exam dumps or proprietary question banks.

About

Open-source local ExSim + NetSim practice platform for CCNA/CCNP

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages