Images and videos from OpenRouter, OpenAI and Google models, at the provider's price.
A website, a Telegram bot and a Mini App, built as one Go service.
framy.ws04.cc
Status · Where It Works · Free And Your Keys · How It Works · Run It Locally · Docs
New image and video models come out every month, each behind its own site, its own credits and its own price list. Paying for three subscriptions to compare two models is silly, and the chat where the photo is never has the model.
framy is deliberately narrow:
| Need | framy approach |
|---|---|
| One place to make an image or a video | One prompt line and every model your keys unlock |
| Changing a video you already have | Attach it like a photo, uploaded or made in framy; the editing models are in the same list |
| An honest price | The provider's price before every run, in USD and in your currency; the actual cost after |
| Telegram as a first-class place | /img and /edit in any group, whole albums as input, a preview to confirm, the result in place |
| Models that change every month | The catalog is data synced from OpenRouter every hour, not code |
| Not another credit reseller | A small free allowance; everything else runs on your own keys with nothing added |
| Familiar stack | Go, the family's tg client, shared Asterfield core, one service |
framy is in alpha and in use: the site at framy.ws04.cc and @framyin_bot run the newest pre-release, the one on the badge above and on Releases. There is no stable version yet.
What it does today:
- images and videos on the models of OpenRouter, OpenAI and Google, with the price before each run and the cost the provider reported after it;
- on the site and in the Mini App, several results from one press, each with its own model, clips that go on with Continue, a library of everything made, and the settings with your keys and default models;
- in Telegram,
/imgand/editin groups with whole albums as input, a plain message in the DM, past results in any chat by@framyin_bot(inline mode), and@framyin_botin reply to a photo where the bot is not a member (guest mode); - the free allowance, and OpenRouter, OpenAI and Gemini on your own keys.
Still to come: the editor of a result, a mask for OpenAI edits and public links to results. Work is tracked on the project board.
| Surface | What it does |
|---|---|
| Site | Composer, model picker with prices, history, settings, provider connections. The main interface |
| Mini App | The same frontend, opened from the bot |
| Group | /img a prompt: an image from scratch, or an edit when it replies to a photo or an album. /edit a prompt in reply to a video |
| DM | A plain message, then a choice of image or video; settings and results made on the site |
| Inline mode | @framyin_bot in any chat lists your past results, to send one again |
| Guest mode | @framyin_bot a prompt in reply to a photo, in a chat where framy is not a member |
In a group, framy first shows which photos it took and waits for Create. Only after that does the message turn into a progress loop and then into the result.
- Free: 5 images in any 24 hours and 1 video in any 7 days, on cheap models that still edit well, paid by framy. The video can instead be an edit of a clip up to 5 seconds.
- Your keys: connect OpenRouter with one button, or paste a key from OpenAI or Google AI Studio. Every run then goes to the provider at its own price, and framy adds nothing.
- Keys are encrypted at rest and never shown again past their last four characters.
framy is one Go service on the family's home server. PostgreSQL holds the
state in a framy schema of the shared core-postgres; files live in
Cloudflare R2. Telegram goes through
FreshLabDev/tg and the family's own Bot
API server.
http server -> site and Mini App, API, progress over SSE, OAuth, webhooks
bot -> /img and /edit in groups and DMs, album cache, delivery
workers -> jobs in Postgres, OpenRouter / OpenAI / Gemini adapters
catalog -> hourly OpenRouter sync, descriptors, daily currency rates
Docker and a test bot of your own from @BotFather are enough to start:
cp .env.example .env
mkdir -p secrets # then put the test bot's token in secrets/bot-token
docker compose up --buildThe bot answers /start, the catalog syncs from OpenRouter, and the site
opens on http://localhost:8080. Making a picture needs an R2 bucket and an
OpenRouter key; .env.example says what each setting is for and what stays
off without it. go test ./... runs the tests; AGENTS.md has
the database, media and browser checks.
| Document | Purpose |
|---|---|
| framy.ws04.cc | The site itself |
| Design | The product: surfaces, accounts, keys, catalog, prices, the free allowance, jobs, /img and /edit, storage, security |
| Research | Models, providers, Telegram and the build, with sources (in Russian) |
| Versioning | Pre-release and stable version line |
| Release process | Changelog, GitHub Release, deploying |
| Changelog | What each release changed |
| Security | How to report a vulnerability privately |
| Project board | Every task and its status, on the Asterfield board's framy tab |
Project board · Changelog · Apache-2.0 · NOTICE
framy is open source software by Asterfield.
Copyright 2026 Asterfield.