MINTO: Jij Management and Insight tool for Optimization
minto is a Python library designed for developers working on research and development or proof-of-concept experiments using mathematical optimization. Positioned similarly to mlflow in the machine learning field, minto provides features such as saving optimization results, automatically computing benchmark metrics, and offering visualization tools for the results.
Primarily supporting Ising optimization problems, plans to extend its support to a wide range of optimization problems, such as MIP solvers, in the future.
Installation
minto can be easily installed using pip.
pip install minto
Documentation and Support
Documentation is hosted on Read the Docs: https://jij-inc-minto.readthedocs-hosted.com/latest/
The published site exposes both English and Japanese under /en/ and /ja/.
Tutorials will be provided in the future. Stay tuned!
Building Documentation Locally
The documentation is built with Jupyter Book 2 and MyST. The canonical build entrypoint is docs/build.py, which also regenerates API pages and converts Jupytext-backed sources before building each language.
Quick Start
The easiest way to build and view the documentation locally:
# Build and open the English and Japanese documentation
task book
# Build and open the Japanese documentation
task book_ja
# Build and open the English documentation
task book_en
# Stop local preview servers when you are done
task stop_book
task stop_book_ja
task stop_book_en
Editing Documentation
The documentation source is organized into separate English and Japanese trees:
docs/
├── en/ # English documentation
│ ├── myst.yml
│ └── ...
├── ja/ # Japanese documentation
│ ├── myst.yml
│ └── ...
├── index.html # Read the Docs root entrypoint
├── build.py # Local/RTD build entrypoint
├── generate_api.py # API doc generator
└── templates/ # API doc templates
Adding New Pages
- Create your content file (
.md,.ipynb, or Jupytext-backed.py) in the appropriate language directory - Add the file to
project.tocin the corresponding language'smyst.yml - Rebuild the documentation using the commands above
Read the Docs Configuration
The repository root .readthedocs.yaml builds both languages in one Read the Docs project and publishes them under /en/ and /ja/.
Common Issues
- Build errors: Make sure you have all dependencies installed with
uv sync --dev - Generated pages not updating: Re-run
task build_book_ja,task build_book_en,task book, oruv run python docs/build.py --lang ... - Preview server still running: Stop the local HTTP preview with
task stop_book,task stop_book_ja, ortask stop_book_enbefore reusing the same port - API documentation: Generated automatically from source code by
docs/generate_api.pyusing Griffe and Jinja2
How to Contribute
See CONTRIBUTING.md
Copyright (c) 2023 Jij Inc.
1 maintainer
Release files for minto 2.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| minto-2.0.0.tar.gz | 830.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| minto-2.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 867.7 kB
Release files / minto-2.0.0.tar.gz
| Download URL | minto-2.0.0.tar.gz |
|---|---|
| Size | 830.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f6c425f1486e30768c26d28fc36c9cce06fe033b208efe41c7db4e930408b2f6
|
|
BLAKE2b-256 checksum How to use checksums |
383584c54b3a93c0c35a2ac6ded25cac6c3ae7799a012c3c02370f37ecd627fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 13, 2026.
Transparency logRelease files / minto-2.0.0-py3-none-any.whl
| Download URL | minto-2.0.0-py3-none-any.whl |
|---|---|
| Size | 36.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0b58bd2f52d616761bc8d897c8efa4498d009cacdb4747b13272562ce186767c
|
|
BLAKE2b-256 checksum How to use checksums |
da5b294ebc63a1a5fa28662b62282e9845496ad3a5c53c639dc65ab45038b5b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 13, 2026.
Transparency log
