Skip to content
zskbot edited this page Aug 20, 2026 · 1 revision

Gemiwi

Gemiwi Banner

AI-powered application builder, development workspace, and autonomous build platform.

Build License PRs


Overview

Gemiwi is an AI-first development workspace designed to help developers build, run, inspect, preview, and iterate on applications from a unified interface.

The platform combines AI interaction, build automation, workspace management, development tools, templates, integrations, package libraries, live activity monitoring, and application preview.

Gemiwi Architecture


Workflow

Describe → AI → Build → Execute → Preview → Iterate

Instead of switching between multiple development tools, users can interact with Gemiwi and let the platform coordinate the development workflow.


Quick Start

Installation

Terminal Execution

Prerequisites

  • Node.js 20+
  • npm or yarn
  • Git
  • Go 1.22+ (for backend agent)

Installation

# Clone the repository
git clone https://github.com/Gemiwi/gemiwi.git
cd gemiwi

# Install dependencies
npm install

# Start development server
npm run dev -- --host 0.0.0.0

Open http://127.0.0.1:5173 in your browser.

Configuration

# Copy environment file
cp .env.example .env

# Edit with your credentials
nano .env

Required environment variables:

PORT=8787
MODEL_PORT=8788

# AI Providers
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
GEMINI_API_KEY=
OPENROUTER_API_KEY=

# OAuth (optional)
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
SESSION_SECRET=

Core Features

AI Chat

Gemiwi provides an AI conversational interface for interacting with the development workspace.

  • Ask technical questions
  • Generate code
  • Request application changes
  • Ask the AI to build applications
  • Select AI models
  • Use automatic model routing
  • Trigger build operations
  • Receive build results
  • Inspect generated applications

Build Agent

The Build Agent converts natural-language instructions into application development tasks.

User Request → AI Model → Build Agent → Workspace → Application Build → Preview

Activity Monitor

Real-time visibility into workspace operations:

  • Build operations
  • Agent activity
  • Workspace events
  • File operations
  • Errors
  • Build results
  • Runtime status

Preview

Inspect generated applications in a browser-style preview environment.

Tools

  • Build Agent - Build and execute applications
  • Preview - Run and inspect generated apps
  • Code Runner - Execute code in the sandbox
  • File Manager - Inspect workspace files
  • Git - Branches, commits and changes
  • Package Manager - Manage project dependencies

Templates

Start from production-ready foundations:

  • Landing Page
  • SaaS Dashboard
  • AI Chat
  • Portfolio
  • E-commerce
  • API Service

Integrations

  • GitHub
  • VS Code
  • npm
  • Vercel
  • Cloudflare
  • Webhooks

Screenshots

Dashboard
Main Dashboard

AI Chat
AI Chat Interface

Tools
Build Tools


Demo

Gemiwi Demo
Demo GIF


Tech Stack

Component Technology
Frontend React 19 + Vite 6
Backend Go 1.22
AI Gateway Go + OpenAI / Anthropic / Gemini
Styling Custom CSS (Carbon-inspired dark theme)
Icons Carbon Icons React

Development

Run Frontend

npm run dev -- --host 0.0.0.0

Run Backend

cd backend
go run .

Build Production

npm run build

Run Tests

npm test

Project Structure

gemiwi/
├── backend/
│   ├── go.mod
│   ├── main.go
│   └── gemiwi-agent
├── frontend/
│   └── src/
│       ├── main.jsx
│       └── carbon.css
├── model-gateway/
│   ├── go.mod
│   ├── main.go
│   └── gemiwi-model-gateway
├── src/
│   ├── main.jsx
│   └── carbon.css
├── public/
│   └── index.html
├── docs/
│   ├── demo/
│   ├── images/
│   └── screenshots/
├── gemiwi.js
├── gemiwi-agent.js
├── gemiwi-build.js
├── gemiwi-tools.js
├── server.js
├── index.html
├── vite.config.js
├── package.json
├── package-lock.json
├── .env.example
├── .gitignore
├── setup-gemiwi.sh
├── start-gemiwi.sh
└── rebuild-gemiwi.sh

API Endpoints

Health

GET http://127.0.0.1:8787/api/health

Events

GET http://127.0.0.1:8787/api/events

Files

GET http://127.0.0.1:8787/api/files

Chat

POST http://127.0.0.1:8787/api/chat
Content-Type: application/json

{
  "prompt": "Build a modern landing page"
}

Preview

GET http://127.0.0.1:8787/preview

Sponsors / Nhà tài trợ

Sponsors

Sponsor


Roadmap

  • AI Chat interface
  • Build Agent
  • Activity Monitor
  • Preview
  • Advanced AI model routing
  • More free AI providers
  • Streaming AI responses
  • Real-time terminal
  • File editor
  • Integrated Git interface
  • GitHub authentication
  • Repository import/export
  • VS Code integration
  • Extension marketplace
  • Package marketplace
  • Template marketplace
  • Deployment integrations
  • Cloud workspace
  • Multi-user collaboration

Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'feat: add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

MIT License - see the LICENSE file for details.


Links


Gemiwi
Build with AI. Develop faster. Preview instantly. Iterate continuously.

a

Clone this wiki locally