Skip to main content

Inventory Management System

A comprehensive platform for tracking products, managing stock movements, and generating detailed inventory reports with role-based access control.

Get StartedExplore API

Quick start

Get your inventory system up and running in minutes

1

Install dependencies

Clone the repository and install the required Python packages.
git clone https://github.com/mauricio-777/InventoryPython.git
cd InventoryPython
pip install -r requirements.txt
2

Start the backend server

Launch the Flask API server on port 8000.
cd backend
python main.py
The database will be automatically created with default roles and an admin user on first startup.
3

Start the frontend

In a new terminal, launch the React frontend.
cd frontend
npm install
npm run dev
The application will be available at http://localhost:5173
4

Log in

Use the default admin credentials to access the system. The credentials are created automatically during the seed process.
Check the console output from the backend server for the default admin username and password.

Key features

Everything you need to manage your inventory effectively

Product management

Track products with SKUs, categories, pricing, and expiration dates

Batch tracking

Manage inventory by batch with quantity and cost tracking

Stock movements

Record entries, exits, and adjustments with full audit trails

Point of sale

Register sales transactions with automatic FIFO costing and profit calculation

Reports & analytics

Generate valuation reports, rotation metrics, and dashboard insights

Role-based access

Control permissions with Admin, Manager, and Consultant roles

Stakeholder management

Manage customers and suppliers with contact information

Explore by topic

Dive deeper into specific areas of the system

Architecture

Understand the hexagonal architecture and system design patterns

Learn more

User management

Set up authentication, manage users, and configure role-based permissions

Learn more

API reference

Complete REST API documentation with endpoints, parameters, and examples

Learn more

Reports & dashboards

Generate inventory valuation, rotation analysis, and real-time metrics

Learn more

Ready to get started?

Follow our quickstart guide to set up your inventory management system in minutes, or explore the full documentation to learn about advanced features.

View quickstartInstallation guide

Build docs developers (and LLMs) love

Get started for freeTalk to us