Skip to content

README.md

Latest commit

 

History

History
131 lines (97 loc) · 4.84 KB

README.md

File metadata and controls

131 lines (97 loc) · 4.84 KB

Galaxy Workspace 🌌

AI-powered coding environment with integrated file management – a VS Code-like workspace with free AI assistance powered by puter.js

✨ Overview

Galaxy Workspace is an intelligent coding environment that combines the familiar interface of modern code editors with integrated AI assistance. Unlike traditional IDEs, Galaxy provides free AI-powered code generation, explanation, and review capabilities directly within your workspace, making it the perfect tool for developers, learners, and coding enthusiasts.

🚀 Key Features

🤖 AI-Powered Coding

  • Generate code with natural language prompts
  • Explain concepts and clarify complex code
  • Review your work with intelligent suggestions
  • Get real-time AI assistance while you code

📁 Integrated File Management

  • VS Code-like interface with intuitive file navigation
  • Create, edit, organize, and manage files seamlessly
  • Project-based workspace organization

🛠️ Workspace Tools & Commands

Feature Description Command Syntax
📄 Create File Create or overwrite files with AI-assisted content CREATE_FILE:filename.ext
language<br>content<br>
✏️ Edit File Suggest complete edits to existing files EDIT_FILE:filename.ext
language<br>new content<br>
🔍 Edit Region Replace specific sections in large files (recommended) EDIT_REGION:filename.ext
SEARCH:
language<br>exact snippet<br>
REPLACE:
language<br>new snippet<br>
📖 Read File View contents of any file in workspace READ_FILE:filename.ext
▶️ Run Python Execute Python files in a safe environment RUN_FILE:filename.ext
🔧 Lint/Analyze Get code analysis and suggestions LINT_FILE:filename.ext
🗑️ Delete File Remove files (requires explicit user request) DELETE_FILE:filename.ext

🎯 Getting Started

Quick Access

  1. Workspare environment configuration:
  • Copy the example env file:
    • cp .env.example .env
  • Set your key values:
    • LOGIN_USER=username
    • LOGIN_PASS=password
  1. Open Galaxy Workspace in your browser
  2. Choose your starting point:
    • Create a new file with AI assistance
    • Start a chat with the AI assistant
    • Load an example project
    • Initialize from a template

Optional: OpenRouter Provider

You can use OpenRouter for chat instead of Puter.

  1. Set your API key in the .env file:
    • OPENROUTER_API_KEY=your_key_here
  2. Restart the server.
  3. In Settings, switch Provider to OpenRouter and set a model (e.g. openai/gpt-4o-mini).

AI Assistance Examples

// Ask the AI to: "Create a React component for a login form"
// Or: "Explain how async/await works in JavaScript"
// Or: "Review this function for potential bugs"

🔧 How It Works

  1. Open the Workspace – Launch Galaxy in your browser
  2. Choose Your Task – Start coding, chatting, or exploring
  3. Leverage AI – Use natural language to get coding help
  4. Manage Files – Organize your work in the integrated file system
  5. Build Projects – Create anything from single files to complete applications

🌟 Use Cases

🧑‍💻 For Developers

  • Rapid prototyping with AI assistance
  • Code review and optimization
  • Learning new frameworks and languages

🎓 For Students & Learners

  • Get explanations for complex concepts
  • Practice coding with AI guidance
  • Understand best practices

💡 For Creators

  • Build projects from ideas
  • Generate boilerplate code
  • Experiment with different approaches

🎨 Interface Highlights

  • Clean, familiar layout – Feels like VS Code
  • AI chat panel – Integrated alongside your code
  • File explorer – Full project management
  • Templates gallery – Quick-start professional projects
  • Example library – Learn from AI-generated code

⚡ Performance & Accessibility

  • Browser-based – No installation required
  • Free AI – No API keys or subscriptions needed
  • Lightweight – Fast loading and responsive
  • Accessible – Works on various devices

🔮 Roadmap & Future

This is just the beginning! Future updates may include:

  • Collaboration features
  • Plugin/extension system
  • Cloud storage integration
  • Mobile app version
  • Additional language support

📞 Support & Community

  • Issues: Report bugs or request features
  • Feedback: Help improve Galaxy Workspace
  • Share: Tell others about this free AI coding tool

Start exploring the galaxy of coding possibilities today! 🚀

No credit card required • No API keys needed • Completely free AI assistance

Note: Galaxy Workspace leverages puter.js for AI functionality, providing an accessible coding environment for everyone.