Requesto

A self-hostable API client. No accounts, no cloud, no telemetry.

Light Mode	Dark Mode

Features

• Self-hosted: All data stored locally in JSON files - on your machine or your server
• Full HTTP support: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
• Authentication: Basic, Bearer, API Key, Digest, and OAuth 2.0 (Authorization Code, PKCE, Client Credentials, Implicit, Password)
• Environment variables: Define variables per environment and reference them in URLs, headers, and bodies
• Collections & folders: Organize requests with drag-and-drop, import and export as JSON
• Workspaces: Isolate projects into separate workspaces, each with their own collections, environments, and OAuth configs
• Git integration: Built-in git support with commit, push, pull, conflict resolution, and branch tracking
• OpenAPI import & sync: Import OpenAPI v2/v3 specs to generate collections, then keep them in sync as the spec changes
• Postman compatibility: Import and export collections and environments in Postman v2.1.0 format
• Console logging: Request/response logs with status codes, timing, and full payloads
• Dark/Light themes: Dark-mode-first UI with a light mode toggle
• CORS-free: Backend handles CORS so the frontend never hits cross-origin issues
• SSE support: Stream Server-Sent Events endpoints
• Multiple deployment options: Desktop app (Windows/macOS/Linux), Docker, or from source

Quick Start

Desktop App

Download for Windows, macOS, or Linux from the releases page.

• Windows: .exe installer or portable
• macOS: .dmg
• Linux: .AppImage, .deb, .rpm

Docker

docker run -d \
  -p 4747:4747 \
  -v requesto-data:/app/data \
  terrii/requesto:latest

Open http://localhost:4747.

Or with Docker Compose:

docker-compose up -d

From Source

git clone https://github.com/t3rr11/Requesto.git
cd Requesto
npm install
npm run dev

Backend runs on port 4747, frontend dev server on port 5173.

Development

Prerequisites

• Node.js 20+
• npm
• Git

Project Structure

Requesto/
├── apps/
│   ├── backend/      # Fastify backend server (port 4747)
│   ├── frontend/     # React/Vite UI (port 5173 in dev)
│   ├── electron/     # Electron desktop wrapper
│   ├── website/      # VitePress documentation site
│   └── playwright/   # End-to-end tests
└── package.json      # Root workspace config

Available Scripts

Command	Description
npm run dev	Backend + frontend dev servers
npm run dev:electron	All three with Electron window
npm run build	Build all apps for production
npm run build:backend	Build backend only
npm run build:frontend	Build frontend only
npm run package:electron:win	Windows installer
npm run package:electron:mac	macOS dmg
npm run package:electron:linux	Linux packages
docker-compose up --build	Build and run Docker image

Architecture

Frontend (React/Vite) ←→ Backend (Fastify) ←→ External APIs
        ↓
Electron Wrapper (Desktop)

• Frontend: React, TypeScript, Vite, TailwindCSS, Zustand
• Backend: Node.js with Fastify - manages collections, environments, workspaces, git operations, OpenAPI importing, request execution, and OAuth token exchange
• Desktop: Electron wrapper that bundles the backend as a child process
• Storage: JSON files on disk organized by workspace - no database

Documentation

Full documentation is available at requesto.com.au.

• Introduction - What Requesto is and how it works
• Getting Started - First request, collections, environments
• Download & Install - Desktop, Docker, and source installation
• Workspaces - Isolate projects into separate workspaces
• Git Integration - Built-in version control for workspaces
• OpenAPI Import & Sync - Import and sync OpenAPI specs
• Docker Deployment - Compose files, environment variables, reverse proxy
• Building from Source - Development setup and packaging
• Security - Security policy and vulnerability reporting

Disclosure

AI was used to assist development.

License

MIT