Skip to content

Cuby-Project/Cuby-solve-API

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧩 Cuby Solve API

GitHub stars GitHub forks GitHub issues GitHub last commit

📝 Description

Cuby Solve API is a Python-based web application that provides an API to solve Rubik's cubes. Built using the Flask framework and leveraging the Kociemba algorithm, this API offers efficient and accurate cube solving capabilities for the Cuby ecosystem.

🔗 Related Projects

✨ Features

  • 🎯 Fast cube solving using Kociemba algorithm
  • 🔄 RESTful API endpoints
  • ⚡ Optimized solving times
  • 🛡️ Robust error handling
  • 🐳 Docker support
  • 📝 Comprehensive documentation

🚀 Getting Started

🔧 Prerequisites

  • Python 3.12
  • pip
  • Docker (optional)

🛠️ Installation

  1. Clone the repository:
git clone https://github.com/Cuby-Project/Cube-solve-API.git
  1. Install dependencies:
pip install -r requirements.txt
  1. Run the application:
python run.py

The application will be available at http://127.0.0.1:5000/.

🐳 Docker Support

Follow the steps in the Docker Guide to run the application using Docker.

🌐 API Usage

Solve Rubik's Cube

Make a GET request to the /solve/<cubeString> endpoint where cubeString is a string representation of the Rubik's cube.

Example:

curl http://127.0.0.1:5000/solve/your-cube-string

Response:

{
  "solution": "R U R' U'",
  "moves": 4,
  "time": 0.123
}

🛠️ Built With

🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

🔮 Roadmap

  • Enhanced solving algorithms
  • Additional cube type support
  • Performance optimizations
  • Extended API endpoints
  • WebSocket support for real-time solving

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

quentinformatique

📞 Support

About

A python Flask API to solve a rubik's cube

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors