VibeTools

An all-in-one developer toolbox. AI-powered utilities and classic dev tools, in one self-hosted app.

Demo · Getting Started · AI Tools · Dev Tools · Self-Hosting · Docs

---

VibeTools replaces the 31 browser tabs you open every day — JSON formatter, JWT decoder, AI summarizer, HTTP client, QR generator, and more — with a single self-hosted app. No accounts, no telemetry, no internet required after setup.

Live demo: https://tool.genzdev.net

Vietnamese: README_VN.MD

Features

• 31 tools across AI and developer categories
• AI tools powered by OpenAI, Google Gemini, or Vertex AI
• Dev tools run entirely in the browser — no data leaves your machine
• Single binary — Go backend with the React SPA embedded inside
• Self-hostable in minutes via Docker or from source
• Multilingual UI — English and Vietnamese

---

Getting Started

Docker

The fastest way to get started:

docker run -p 8080:8080 ghcr.io/kevinxvu/vibe-tools:latest

Open http://localhost:8080

From Source

Prerequisites: Go 1.24+, Docker, air, wire, swag

git clone git@github.com:kevinxvu/vibe-tools.git
cd vibe-tools

make provision   # Start database container and run migrations
make dev         # Start the server with hot reload

---

AI Tools

AI tools call your configured LLM provider. See LLM (AI Features) to set one up.

Tool	Description
Chat to Article	Turn a chat log or Slack thread into a structured technical article.
Text Summarizer	Summarize long content in multiple styles — bullets, paragraph, TLDR, executive.
Email Generator	Draft professional emails in different tones from a short brief.
Smart Chat Reply	Get reply suggestions from a conversation thread or a screenshot.
AI Transcriber	Transcribe audio or video files to text, json, or srt.
AI Translator	Context-aware translation with configurable source/target language and tone.
OCR Tool	Extract text from images — screenshots, scanned documents, whiteboard photos.
Markdown Format	Clean up messy or malformed markdown into a consistently formatted version.
Markdown Parser	Convert HTML, plain text, URLs, or files (DOC, XLSX, PDF) to clean Markdown.
Mermaid Generator & Live Preview	Generate Mermaid diagrams from descriptions, then edit source beside a live preview.

---

Dev Tools

All dev tools run locally in the browser. No data is sent to any server.

Tool	Description
HTTP Client	Send REST requests and inspect responses, headers, and status codes.
JSON Formatter	Pretty-print, minify, validate, and explore JSON as a tree.
JWT Tool	Decode a JWT to inspect its claims, or encode a new one with a custom secret.
Markdown Viewer	Live editor and preview with synchronized scrolling.
HTML Viewer	Edit and preview HTML with live rendering, tree view, and beautify.
XML Formatter	Format, minify, and explore XML as an interactive tree.
String Hash	Compute MD5, SHA-1, SHA-256, SHA-512, and Keccak hashes.
Bcrypt Tool	Hash a password with bcrypt, or verify a password against a hash.
String Length Calculator	Count characters, words, lines, and tokens. Useful for sizing LLM prompts.
Multiline Converter	Join, quote, bracket, or transform multi-line text in one click.
Text Case Converter	Convert between camelCase, PascalCase, snake_case, kebab-case, slug, and more.
String Escaper	Escape and unescape for HTML, XML, JS, JSON, CSV, and SQL.
Text Replacer	Template replacement with {{variable}} placeholders.
HTML Encoder	Encode and decode HTML entities.
Base64 Converter	Encode and decode Base64 — text or file content.
URL Converter	URL-encode and decode strings and query parameters.
Password Generator	Generate strong passwords with configurable character sets and length.
UUID Generator	Generate v4 and v7 UUIDs and inspect the fields of any UUID.
Snowflake Generator	Generate Snowflake IDs and decode the embedded timestamp and machine ID.
Timestamp Converter	Convert between Unix, milliseconds, and RFC3339 datetime formats.
Log Analyzer	View and filter structured JSON logs (SQL, API) in a clean table layout.
QR Generator & Reader	Generate customizable QR codes with logo/watermark, and decode QR codes from images via upload or paste.

---

Self-Hosting

Docker

docker run -d \
  --name vibe-tools \
  -p 8080:8080 \
  -e LLM_TEXT_MODEL=openai/gpt-5.5 \
  -e LLM_AUDIO_MODEL=openai/gpt-5.5 \
  -e LLM_PROVIDER=openai \
  -e LLM_MAX_INPUT_TOKENS=12000 \
  -e LLM_LIMIT_TOKEN_USAGE=10000000 \
  -e API_BASE_URL="http://localhost:8080" \
  -e OPENAI_API_KEY="your_openai_api_key" \
  -e OPENAI_BASE_URL="your_openai_base_url" \
  ghcr.io/kevinxvu/vibe-tools:latest

Open http://localhost:8080 after the container starts.

Docker Compose

Create docker-compose.yml:

services:
  vibe-tools:
    image: ghcr.io/kevinxvu/vibe-tools:latest
    container_name: vibe-tools
    ports:
      - "8080:8080"
    environment:
      LLM_TEXT_MODEL: openai/gpt-5.5
      LLM_AUDIO_MODEL: openai/gpt-5.5
      LLM_PROVIDER: openai
      LLM_MAX_INPUT_TOKENS: "12000"
      LLM_LIMIT_TOKEN_USAGE: "10000000"
      API_BASE_URL: "http://localhost:8080"
      OPENAI_API_KEY: "your_openai_api_key"
      OPENAI_BASE_URL: "your_openai_base_url"
    restart: unless-stopped

Start the app:

docker compose up -d

Replace OPENAI_API_KEY, OPENAI_BASE_URL, LLM_TEXT_MODEL, LLM_AUDIO_MODEL with your actual values before exposing the app. Keep API_BASE_URL empty when the embedded frontend and backend share the same origin.

For all available options, see the Configuration Reference.

---

Documentation

Document	Description
docs/TECHNICAL.md	Architecture, API reference, development guide, deployment

---

Contributing

Contributions are welcome. Please open an issue to discuss a change before submitting a pull request.

1. Fork the repository
2. Create a feature branch: git checkout -b feat/your-feature
3. Commit your changes
4. Open a pull request

See docs/TECHNICAL.md for architecture details and development setup.

---

License

MIT