{"id":20697259,"url":"https://github.com/dizzydroid/invman","last_synced_at":"2025-06-27T14:06:01.642Z","repository":{"id":247804296,"uuid":"826836891","full_name":"dizzydroid/InvMan","owner":"dizzydroid","description":"An Inventory Management App: Efficiently manage inventory, process orders and refunds, and track performance with this sleek PyQt-based application.","archived":false,"fork":false,"pushed_at":"2024-10-13T22:29:49.000Z","size":740,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-27T14:05:37.240Z","etag":null,"topics":["inventory-management","inventory-management-system","invman","pandas","pyqt5","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dizzydroid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-07-10T13:27:10.000Z","updated_at":"2024-11-04T10:10:33.000Z","dependencies_parsed_at":"2024-07-13T12:25:25.610Z","dependency_job_id":"0f28f917-438c-415d-bbe3-8cd52550ec3a","html_url":"https://github.com/dizzydroid/InvMan","commit_stats":null,"previous_names":["dizzydroid/invman"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/dizzydroid/InvMan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dizzydroid%2FInvMan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dizzydroid%2FInvMan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dizzydroid%2FInvMan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dizzydroid%2FInvMan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dizzydroid","download_url":"https://codeload.github.com/dizzydroid/InvMan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dizzydroid%2FInvMan/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262270430,"owners_count":23285164,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["inventory-management","inventory-management-system","invman","pandas","pyqt5","python"],"created_at":"2024-11-17T00:17:19.823Z","updated_at":"2025-06-27T14:06:01.611Z","avatar_url":"https://github.com/dizzydroid.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# InvMan - Inventory Manager 📦\n\n\u003cdiv id=\"header\" align=\"left\"\u003e\n \u003cimg src=\"headerImg.png\"\u003e\n\u003c/div\u003e\n\nInvMan is a comprehensive inventory management application built with PyQt5. It helps businesses manage their inventory, track performance, and process orders and refunds efficiently.\n\u003e [!NOTE]  \n\u003e InvMan is *currently* tailored for mobile phone shops, but it can be easily adapted for other types of businesses.\n\n## Features ✨\n\n- Add, edit, and remove inventory items\n- Track stock levels by item and model\n- Process orders and refunds\n- Apply discounts to orders\n- Track performance over a specified date range\n- Filter and search inventory by name, phone model, and category\n- User-friendly interface with image support\n\n## Installation ⚙️\n\n### From Executable 💻\n\nTo run InvMan from the executable:\n\n1. Download the latest version of `InvMan.rar` from the [releases page](https://github.com/dizzydroid/InvMan/releases).\n2. Extract and run the executable `main.exe` located in the `dist` directory.\n3. The `dist` folder will hold all the generated files in .xlsx format.\n\n### From Source 🛠️\n\nTo install and run InvMan from source, follow these steps:\n\n1. Clone the repository:\n    ```bash\n    git clone https://github.com/dizzydroid/InvMan.git\n    cd InvMan\n    ```\n\n2. Create and activate a virtual environment (optional but recommended):\n    ```bash\n    python -m venv venv\n    source venv/bin/activate  # On Windows, use `venv\\Scripts\\activate`\n    ```\n\n3. Install the required dependencies:\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n4. Run the application:\n    ```bash\n    python main.py\n    ```\n\n## Dependencies 📚\n\nIf you are running from source, the following dependencies are required:\n\n- Python (*obviously*)\n- PyQt5\n- pandas\n- openpyxl\n\n## Usage 📖\n\nUpon launching the app, you will be presented with a search bar and filter options to easily manage your inventory. You can add new items, edit existing ones, process orders and refunds, and track performance over time.\n\n### Adding a New Item ➕\n\n1. Click the \"Add Item\" button.\n2. Enter the item details, including name, category, image, and models.\n3. Click \"Add Item\" to save.\n\n### Processing an Order 🛒\n\n1. Click on an item to open its options.\n2. Click \"Order\" and fill in the order details.\n3. Click \"Order\" to generate a receipt and update the inventory.\n\n### Tracking Performance 📈\n\n1. Click the \"Track Performance\" button.\n2. Select the start and end dates.\n3. Click \"Track Performance\" to view the net profit for the selected period.\n\n## Found Bugs? 🐞\n\nIf you encounter any bugs, please report them by creating an issue on the [GitHub Issues](https://github.com/dizzydroid/InvMan/issues) page.\n\n## Contributing 🤝\n\nContributions are welcome! Please fork the repository and create a pull request with your changes.\n\n## License 📄\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgements 🙏\n\nThanks to the open-source community for providing the tools and libraries that made this project possible.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdizzydroid%2Finvman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdizzydroid%2Finvman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdizzydroid%2Finvman/lists"}