Metadata-Version: 2.4
Name: rubikoslav
Version: 0.4.1
Summary: C++ Rubik's Cube engine, adaptive solver, Python API, and interactive visualizer
Keywords: rubiks-cube,solver,cpp,pybind11,visualization
Author: Jaloliddin Ismailov
License-Expression: GPL-3.0-only
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: C++
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Games/Entertainment :: Puzzle Games
Project-URL: Homepage, https://rubikoslav.vercel.app
Project-URL: Documentation, https://unnobatroo.github.io/rubikoslav/
Project-URL: Repository, https://github.com/unnobatroo/rubikoslav
Project-URL: Issues, https://github.com/unnobatroo/rubikoslav/issues
Requires-Python: >=3.10
Requires-Dist: cube-solver==1.1.4
Requires-Dist: typing-extensions==4.15.0
Description-Content-Type: text/markdown

# Rubikoslav

[![PyPI](https://img.shields.io/pypi/v/rubikoslav?label=PyPI)](https://pypi.org/project/rubikoslav/)
[![Wiki](https://img.shields.io/badge/docs-wiki-2878EB?logo=materialformkdocs&logoColor=white)](https://unnobatroo.github.io/rubikoslav/)

Rubikoslav is a reusable 3×3 Rubik's Cube solver. It combines a C++20 cube engine, a Python API and CLI, and an animated browser visualizer. Every returned solution is replayed through the native cube before it is accepted.

## Install the package

Install the published package from PyPI:

```bash
pip install rubikoslav
```

## Use it in Python

```python
from rubikoslav import Rubikoslav

result = Rubikoslav().solve_scramble("R U F2")

if result.success:
    print(result.moves)
```

## Run the visualizer

```bash
uv run rubikoslav
```

Or use the hosted version at [rubikoslav.vercel.app](https://rubikoslav.vercel.app).
