fastlap 0.1.1

Python’s LAP (Linear Assignment Problem) solver — written in Rust for performance

fastlap
High-Performance Linear Assignment Problem Solver

fastlap is a high-performance Python library for solving Linear Assignment Problems (LAP), implemented in Rust for optimal speed and efficiency. Leveraging the PyO3 framework, fastlap seamlessly integrates Rust's performance with Python's ease of use, delivering a lightweight and robust solution for assignment optimization tasks.

✨ Features

• High Performance: Built in Rust for superior computational speed.
• Multiple Algorithms: Supports state-of-the-art LAP algorithms, including LAPJV, Hungarian, LAPMOD, Dantzig’s, Auction, and Subgradient.
• Python Integration: User-friendly Python interface via PyO3.
• Lightweight: Minimal dependencies for easy integration into projects.

📖 Supported Algorithms

• LAPJV — Efficient dual-based shortest augmenting path algorithm (Jonker & Volgenant, 1987)
• Hungarian Algorithm — Classic method using row/column reduction and assignment phases (Kuhn, 1955)
• Dantzig’s Algorithm — Simplex-based method for solving linear assignment problems (Dantzig, 1963)
• Auction Algorithm — Iterative bidding approach for optimal assignment (Bertsekas, 1988)
• Subgradient Algorithm — Optimization method using subgradient updates for assignment problems (Held & Karp, 1971)

🚀 Getting Started

[!WARNING]
fastlap is under active development and may not yet be fully stable. Use with caution in production environments. And to be honest, I am still struggling with publish this package to PyPI.

Installation

To build fastlap from source, ensure you have maturin installed.

# 1. Clone the project

git clone https://github.com/8Opt/fastlap.git
cd fastlap

# 2. Install dependencies
pip install maturin
# or `uv sync`


# 3. Build and install
maturin build
# or maturin develop

Example Usage

import fastlap

# Define a sample cost matrix
cost_matrix = [
    [1, 2, 3],
    [4, 5, 6],
    [7, 8, 9]
]

##  Solve the LAP using the LAPJV algorithm
total_cost, row_assignments, col_assignments = fastlap.solve_lap(cost_matrix, algorithm="lapjv")

print("Total Cost:", total_cost)
print("Row Assignments:", row_assignments)
print("Column Assignments:", col_assignments)

📄 Citation

If you use fastlap in your research or projects, please cite it as follows:

@software{fastlap2025,
  author       = {Le Duc Minh},
  title        = {fastlap: A High-Performance Python LAP Solver Powered by Rust},
  year         = {2025},
  publisher    = {GitHub},
  url          = {https://github.com/8Opt/fastlap},
  note         = {Python-Rust implementation of LAPJV, Hungarian, LAPMOD, Dantzig’s, Auction, and Subgradient algorithms}
}

📃 License

fastlap is licensed under the MIT License © 2025.

🛠️ Contributing

Contributions are welcome! Please see our Contributing Guidelines for more details on how to get involved.

📧 Contact

For questions or support, please open an issue on the GitHub repository or contact the maintainers directly.