Skip to content

Orinks/Spectra

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Spectra

Spectra is an accessible OpenAPI documentation browser and REST client for blind and low-vision developers.

Swagger UI and many API tools can be difficult to use with screen readers. Spectra is designed as a keyboard-first desktop app with explicit labels, status updates, and readable text output.

Features

  • Load OpenAPI 3.x and Swagger 2.x specs from local JSON/YAML files or URLs
  • Browse endpoints grouped by tag in a keyboard-navigable tree
  • Read endpoint details in text form: method, path, summary, parameters, request body, and responses
  • Send requests from a built-in REST client with headers, auth, and body editing
  • Review response status, headers, and pretty JSON body
  • Track request history (last 50 requests) and repopulate requests quickly
  • Accessibility-focused controls and keyboard shortcuts

Installation

pip install -e .

Run:

spectra

Keyboard Shortcuts

Shortcut Action
Ctrl+O Open spec file
Ctrl+U Open spec URL
Ctrl+Enter Send request
Ctrl+H Focus history
Ctrl+F Filter endpoints
F5 Reload current spec
Escape Clear request/response

Development

pip install -e .[dev]
ruff check .
pytest

Contributing

Contributions are welcome. Please open an issue or pull request with:

  • Accessibility impact notes
  • Reproducible test steps
  • Tests for behavior changes

About

Accessible OpenAPI documentation browser and REST client — a screen-reader-friendly Postman alternative

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages