vclient — Auto-Generate API Clients

Auto-discover OpenAPI endpoints and generate type-safe client libraries in 6 languages instantly.

Features

✨ Single Command:

vclient infer https://api.example.com

Generates:

• 🐍 Python (httpx + Pydantic models)
• 📘 TypeScript (Fetch API + Zod validation)
• 🐹 Go (net/http)
• 🦀 Rust (reqwest + serde)
• ☕ Java (HttpClient)
• 💎 Ruby (Faraday)

How It Works

1. Discover — Probe API endpoints and extract OpenAPI specs
2. Infer — Analyze responses → infer complete JSON schemas
3. Cache — Store schemas, detect drift on next run
4. Generate — Produce idiomatic clients for all 6 languages

Installation

# via PyPI
pip install vclient

# via Homebrew (after setup)
brew install yc-trails/vclient/vclient

Quick Start

# Infer schema from live API
vclient infer https://be.vyonica.com --max-endpoints 25 \
  --gen-python --gen-typescript --gen-go --gen-rust --gen-java --gen-ruby

# Generates: schema.json + client.py + client.ts + client.go + client.rs + Client.java + client.rb

Generate from Existing Schema

vclient codegen schema.json \
  --python client.py \
  --typescript client.ts \
  --go client.go \
  --rust client.rs \
  --java Client.java \
  --ruby client.rb

Architecture

vclient/
├── src/
│   ├── cli.py           # Command-line interface
│   ├── sampler.py       # Endpoint discovery + HTTP sampling
│   ├── inferrer.py      # Schema inference from responses
│   ├── codegen.py       # 6-language code generation
│   └── cache.py         # SQLite schema caching + drift detection
├── tests/               # 55+ unit tests
├── test-clients/        # Generated examples (153 Vyonica endpoints)
└── Formula/vclient.rb   # Homebrew formula

Testing

All generators tested on real-world APIs:

# Run test suite
pytest tests/ -v

# Test with Vyonica API (153 endpoints)
vclient infer https://be.vyonica.com --no-cache

What's Next

• Windows binary (Windows Subsystem for Linux compatible)
• Kotlin support (JVM ecosystem)
• GraphQL support
• API documentation generation

Made for: AI agents, SaaS integrators, enterprises calling legacy APIs without OpenAPI specs.