Home

Welcome to the Pynventory wiki.

Use this wiki to get the app running, make safe contributions, and follow the project's current direction. This page is the main index for the wiki.

Start here

New here? Follow the path below from setup to your first merged pull request.

Contributor path

Issue → Branch → Code → Test → PR → Review → Merge

Step	Page
Setup	Getting started - install Python, create a venv, run the app
Your first change	Your first contribution - pick an issue, branch, change, test, open a PR
How we work	Contributor workflow - branching rules, PR process, communication
Git commands	Git commands - clone, commit, merge, conflicts, undo, and more
Code review	Code review - how to review a PR and what reviewers look for
Code style	Code style guide - naming, Ruff, what good code looks like here
Testing	Testing guide - how to test your change before opening a PR

Reference pages

• Troubleshooting - fixes for common problems
• FAQ - quick answers to common questions
• Architecture & roadmap - project structure and future plans
• Release guide - how and when versions are tagged
• Useful links - external resources for Python, Git, SQLite, and code quality

Current project phase

Pynventory is currently focused on improving the terminal-based inventory app before moving toward a web interface.

For more detail, see the Architecture & roadmap page.

Project management

Use GitHub Issues to report bugs, suggest features, ask tracked questions, and discuss planned work. Before starting work, check whether an issue already exists.

Issues · Labels · Project board

If a decision affects future contributors, document it in the wiki or link to the GitHub issue where the decision was made.