A Note from the Author — Please Read This

Hi, I'm Willen Ponce. I built WallasAPI alone, in stolen hours between worrying about rent and the next meal, on a 2018 laptop, in a rented room in Peru that isn't mine.

I have no investors. No team. No company. Just code, determination, and the desperate need to prove that you don't need Silicon Valley money to build something useful.

If WallasAPI saves you even one hour of integration work, please consider:

• ⭐ Starring this repo — costs you nothing, helps me enormously
• 💛 Buying me a coffee on Ko-fi or via PayPal — even $1 changes my day
• 📧 Sending an email to wubjak@protonmail.ch — just say "I'm using WallasAPI for X". That's it. That's enough.

Skip to the donation section →

Why WallasAPI Exists

You're building with AI in 2026. You face a real problem:

• 🔴 OpenAI goes down → your app dies
• 🔴 Your Claude API key expires → users complain
• 🔴 Gemini is free but doesn't accept your file format → manual conversion
• 🔴 You want to use a free model for cheap tasks and a powerful one for hard tasks → you write 200 lines of switching logic
• 🔴 Each provider has a different SDK, different format, different errors

WallasAPI solves all of this with one OpenAI-compatible endpoint. Send a request, and it:

1. Analyzes the content (text, image, audio, PDF, video)
2. Picks the optimal provider based on capabilities, speed, cost, and current availability
3. Routes the request automatically
4. Falls back transparently if the primary provider fails — your user never sees the error
5. Returns the response in standard OpenAI format, with streaming if you asked for it

Your existing OpenAI SDK code works unchanged. Just point it at http://localhost:8001/v1.

What Makes This Different

Every feature here was built because I needed it to ship products without a budget:

Supported Providers

With just Gemini + Groq + GitHub Models (all free) you have access to dozens of state-of-the-art models without paying a cent.

Quick Install (60 seconds)

Windows — Just double-click start.bat

git clone https://github.com/wubjak/wallasapi.git
cd wallasapi
# Double-click start.bat
# Server is up at http://localhost:8001

Linux / macOS

git clone https://github.com/wubjak/wallasapi.git
cd wallasapi
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m wallasAPI.api_server

Interactive Swagger UI: http://localhost:8001/docs

Quick Usage

import openai

client = openai.OpenAI(
    base_url="http://localhost:8001/v1",
    api_key="anything-local"
)

# Don't pick a provider. Pick a strategy.
response = client.chat.completions.create(
    model="auto",  # WallasAPI picks the best free provider available NOW
    messages=[{"role": "user", "content": "Explain quantum entanglement"}]
)
print(response.choices[0].message.content)

Virtual models you can use instead of guessing provider names:

API Endpoints

OpenAI-compatible:

• POST /v1/chat/completions — chat with streaming
• POST /v1/embeddings — multi-provider embeddings
• POST /v1/images/generations — Flux, DALL-E, etc.
• POST /v1/videos/generations — Gemini, HuggingFace
• POST /v1/tts — text-to-speech

WallasAPI exclusive:

• GET /v1/models?pricing=free&capability=vision — filtered model discovery
• GET /v1/models/{id} — full metadata for any model
• GET /v1/capabilities/summary — aggregate stats
• GET /v1/providers — provider-level capabilities
• POST /v1/ocr/process — OCR with auto-fallback
• POST /v1/sync/obsidian — sync conversations to your vault

Configuration

Copy .env.example to .env and fill in only the keys you have. WallasAPI works with whatever you give it.

# 100% free providers (start here)
GEMINI_API_KEY=your_key
GROQ_API_KEY=your_key
GITHUB_TOKEN=your_token

# Optional paid
OPENAI_API_KEY=your_key
OPENROUTER_API_KEY=your_key

How to get free API keys (step by step)

Total: ~10 minutes to get free access to 50+ state-of-the-art models.

License

MIT-based custom license. Use, modify, distribute, deploy commercially — all free. The only ask: keep the attribution to Willen Ponce.

One personal request (not legally required): If you use WallasAPI in any project, please send a one-line email to wubjak@protonmail.ch. A simple "Hey, using WallasAPI for X" literally makes my week. I built this alone and it would mean a lot to know it's helping someone.

See LICENSE for full text.

Donations — Why This Matters

I'm not going to dress this up. I'm a developer in Peru who built this entire project — 17 modules, 12+ provider integrations, 1500+ lines of routing logic, OCR fallback chains, multimodal handling, persistent memory — alone, on a 2018 laptop, in a rented room.

I have no income right now. I'm behind on rent. I haven't eaten properly in days while finishing this. I'm publishing it free because I believe open-source matters more than I matter, and because maybe — just maybe — someone reading this will find it useful and decide to help me eat tomorrow.

What your donation actually does

Every single dollar is documented in my conscience and remembered with gratitude.

How to send help

Yape / Plin (Peru) — Number: 980 702 580

Crypto wallets:

Can't donate? You can still help (it's free)

• ⭐ Star this repo — it costs you nothing and pushes WallasAPI into more developers' feeds
• 🐦 Share it on Twitter/X, LinkedIn, HackerNews, Reddit r/LocalLLaMA, your dev community
• 🐛 Open an issue if you find a bug or have a feature request
• 💬 Send the email to wubjak@protonmail.ch — it's not transactional, it's human

"I built WallasAPI because I refused to accept that being broke meant being unable to ship great software. If it helps you ship something — that's already a victory I'll never forget. If it helps me eat tomorrow — that's a victory neither of us will forget." — Willen Ponce

Acknowledgments

• The teams at FastAPI, Google, Meta, DeepSeek, Mistral, and every provider offering free tiers — you made this possible
• The open-source community — proof that we don't need billion-dollar valuations to build great things
• You — for reading this far. Whether you donate, star, share, or just use it: thank you