🐍 PyBox: Browser-Based Python IDE

🌟 Overview

PyBox is an web-based Python development environment that enables users to write, run, and manage Python code directly in the browser. Using technologies like Pyodide and Wasmer, PyBox offers a seamless coding experience with robust file management, package installation, and experimental integrated terminal support.

✨ Features

🔧 Core Features

Python Editor: Write and edit Python scripts with syntax highlighting and intelligent autocompletion
File Explorer: Manage project files and directories with drag-and-drop support
Resizable Panels: Customize your workspace layout with adjustable file explorer and output panels
Shortcuts: Essential shortcuts like Ctrl+R to run code and Ctrl+S to save files
Theme Support: Switch between light and dark modes for a comfortable coding environment

📦 Package Management

Package Installation: Install Python packages using the built-in package manager
Manage Packages List: View all installed packages directly within the IDE

🖥 Terminal Integration

Bash Terminal: Access a functional Bash shell within the IDE for command-line operations
File System Access: Navigate and manipulate project files through the terminal interface
Environment: Use a Wasmer powered virtualized terminal for secure execution

🐍 Python REPL

Interactive Console: Execute Python commands in real-time and view immediate results
History & Autocompletion: Navigate through previous commands and utilize tab completion for faster coding
Filesystem: Interaction with the virtual filesystem from the REPL is unified and synchronized with the editor

📊 Visualization Support

Matplotlib Integration: Render and view plots and graphs generated by your Python scripts directly within the IDE
HTML5 Integration: Display HTML graph, images, SVGs, and styled text in the visual container
Custom Visualization: Possible to extend the visualization capabilities with custom rendering and display options

🚀 Getting Started

Prerequisites

Node.js (v14 or higher)
Yarn or npm

Installation Steps

Clone the Repository

git clone https://github.com/oct4pie/pybox.git
cd pybox

Install Dependencies
```
yarn install
```
or
```
npm install
```
Launch Development Server
```
yarn dev
```
or
```
npm run dev
```
Access PyBox Open your browser and navigate to:
```
http://localhost:5173/
```

📂 File Management

Creating a New File

Click the Add File button or use the keyboard shortcut Ctrl + N (Windows/Linux) or Cmd + N (macOS)
Enter the file name and press Enter

Renaming

Click the rename icon next to the file tab or right-click the file in the File Explorer and select Rename
Enter the new name and press Enter

Deleting

Click the delete icon next to the file tab or right-click the file in the File Explorer and select Delete

Uploading Files and Directories

Drag and drop files or directories into the File Explorer panel
Alternatively, use the upload button in the File Explorer to select files from your system

Exporting

Click the Export button in the File Explorer to download your entire project as a ZIP archive

⌨️ Keyboard Shortcuts (under dev)

| Action | Shortcut | |-------------------------|--------------------------------------| | Run Code | Ctrl + R (Windows/Linux) Cmd + R (macOS) | | Save File | Ctrl + S (Windows/Linux) Cmd + S (macOS) | | New File | Ctrl + N (Windows/Linux) Cmd + N (macOS) | | Toggle Bottom Panel | Ctrl + B (Windows/Linux) Cmd + B (macOS) | | Open Package Manager | Ctrl + Shift + P (Windows/Linux) Cmd + Shift + P (macOS) |

🛠 Available Scripts

Development
```
yarn dev
```
or
```
npm run dev
```
Runs the app in development mode with hot-reloading.
Production Build
```
yarn build
```
or
```
npm run build
```
Builds the app for production to the build folder.
Preview Production Build
```
yarn preview
```
or
```
npm run preview
```
Serves the production build locally for previewing.
Linting
```
yarn lint
```
or
```
npm run lint
```
Runs ESLint to analyze code for potential errors and enforce coding standards.

📝 To-Do List

[ ] Implement real-time collaboration features.
[ ] Add support for additional programming languages.
[ ] Enhance debugging tools and capabilities.
[ ] Integrate version control systems like Git.
[ ] Improve accessibility for users with disabilities.
[ ] Expand package manager functionalities.

📄 License

PyBox is open-sourced under the MIT License.

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the Repository
Create a Feature Branch
```
git checkout -b feature/YourFeature
```
Commit Your Changes
```
git commit -m "Add Your Feature"
```
Push to the Branch
```
git push origin feature/YourFeature
```
Open a Pull Request

Please ensure your contributions adhere to the project's coding standards and include relevant tests.

🆘 Issues

If you encounter any issues or have questions, feel free to open an issue on GitHub Issues

Pybox

Install / Use

README