{"id":50484379,"url":"https://github.com/codependentai/easel-ai","last_synced_at":"2026-06-01T20:31:37.482Z","repository":{"id":359334837,"uuid":"1221856673","full_name":"codependentai/easel-ai","owner":"codependentai","description":"Local-first BYOK image gallery and AI prompt workshop. Self-hosted Sora my-media replacement.","archived":false,"fork":false,"pushed_at":"2026-05-21T11:23:57.000Z","size":70,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-21T19:51:26.902Z","etag":null,"topics":["byok","gallery","gpt-image","hono","image-generation","local-first","openai","self-hosted","sora","sora-replacement","typescript"],"latest_commit_sha":null,"homepage":"https://github.com/codependentai/easel-ai","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codependentai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-26T19:10:46.000Z","updated_at":"2026-05-21T11:23:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/codependentai/easel-ai","commit_stats":null,"previous_names":["codependentai/easel-ai"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/codependentai/easel-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codependentai%2Feasel-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codependentai%2Feasel-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codependentai%2Feasel-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codependentai%2Feasel-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codependentai","download_url":"https://codeload.github.com/codependentai/easel-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codependentai%2Feasel-ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33793032,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["byok","gallery","gpt-image","hono","image-generation","local-first","openai","self-hosted","sora","sora-replacement","typescript"],"created_at":"2026-06-01T20:31:36.810Z","updated_at":"2026-06-01T20:31:37.477Z","avatar_url":"https://github.com/codependentai.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# easel-ai\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-Apache_2.0-blue.svg\" alt=\"License\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.typescriptlang.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/TypeScript-5.7-3178c6.svg?logo=typescript\u0026logoColor=white\" alt=\"TypeScript\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://nodejs.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Node.js-20+-339933.svg?logo=node.js\u0026logoColor=white\" alt=\"Node.js\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://hono.dev/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Hono-server-ff5f33.svg\" alt=\"Hono\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.sqlite.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Self--Hosted-SQLite-003B57.svg?logo=sqlite\u0026logoColor=white\" alt=\"Self Hosted\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://platform.openai.com/docs/guides/images\"\u003e\u003cimg src=\"https://img.shields.io/badge/OpenAI-gpt--image-412991.svg?logo=openai\u0026logoColor=white\" alt=\"OpenAI\" /\u003e\u003c/a\u003e\n  \u003ca href=\"#why-local-first\"\u003e\u003cimg src=\"https://img.shields.io/badge/BYOK-no_cloud-5eaba5.svg\" alt=\"BYOK\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cem\u003eA local-first, BYOK image gallery with character/style presets and an AI prompt workshop.\u003cbr/\u003eSelf-hosted replacement for Sora's \"my media\" after the April 2026 shutdown.\u003c/em\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cem\u003ePart of the \u003ca href=\"https://github.com/codependentai/resonant\"\u003eResonant\u003c/a\u003e ecosystem — local-first creative tools that outlive the platforms they connect to.\u003c/em\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://x.com/codependent_ai\"\u003e\u003cimg src=\"https://img.shields.io/badge/𝕏-@codependent__ai-000000?logo=x\u0026logoColor=white\" alt=\"X/Twitter\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://tiktok.com/@codependentai\"\u003e\u003cimg src=\"https://img.shields.io/badge/TikTok-@codependentai-000000?logo=tiktok\u0026logoColor=white\" alt=\"TikTok\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://t.me/+xSE1P_qFPgU4NDhk\"\u003e\u003cimg src=\"https://img.shields.io/badge/Telegram-Updates-26A5E4?logo=telegram\u0026logoColor=white\" alt=\"Telegram\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e **Early release.** Built for ourselves after Sora shut down, then put in the open. Shippable but unpolished. Issues and feedback welcome.\n\n## What it does\n\n- **Gallery.** All your generations in one grid. Favourites, folders, trash. Click any image to see the prompt, presets, and generation parameters that made it.\n- **Character \u0026 style presets.** Save reusable prompt fragments — a character description (with an optional reference image to anchor likeness), or a style. Stack multiple characters + a style on a single generation. Versioned: fork a preset to refine without losing the old one.\n- **Workshop.** Two assists for prompting:\n  - *From image:* upload a reference, get a generation-ready prompt that captures its essence.\n  - *Brainstorm:* dump a vague idea, get three distinct generation-ready prompts taking different angles.\n- **Local everything.** SQLite for metadata, flat PNG files on disk for images. Your data never leaves your machine except to call OpenAI.\n\n## Stack\n\n- Node 20+ with [Hono](https://hono.dev/) and `@hono/node-server`\n- `better-sqlite3` for presets, tasks, variants, folders\n- OpenAI SDK for image generation (`gpt-image-1.5` / `gpt-image-2`) and Workshop chat completions\n- Vanilla JS + CSS frontend in `public/` — no framework, no build step\n\n## Install\n\nRequires Node.js 20+. Bring your own OpenAI API key.\n\n```bash\ngit clone https://github.com/codependentai/easel-ai.git\ncd easel-ai\nnpm install\ncp .env.example .env\n# edit .env and add your OPENAI_API_KEY\nnpm run dev\n```\n\nThen open \u003chttp://localhost:5178\u003e.\n\n## Configuration\n\nAll config is via environment variables. See [`.env.example`](./.env.example) for the full list.\n\n| Variable | Default | Notes |\n|---|---|---|\n| `OPENAI_API_KEY` | *(required)* | Get one at \u003chttps://platform.openai.com/api-keys\u003e. |\n| `EASEL_IMAGE_MODEL` | `gpt-image-1.5` | Set to `gpt-image-2` for the newer model — that one **requires a verified organisation** on `platform.openai.com`. |\n| `EASEL_TEXT_MODEL` | `gpt-5.4` | Used by the Workshop. Must support image inputs (vision) for `from-image` to work. |\n| `PORT` | `5178` | HTTP port. |\n\n## Data layout\n\nEverything you generate lives under `data/` (gitignored — never committed):\n\n```\ndata/\n├── easel.db             # SQLite: presets, tasks, variants, folders\n├── images/\n│   └── gen_\u003ctask_id\u003e/\n│       └── 0.png        # one file per variant\n└── refs/\n    └── ref_\u003cid\u003e.png     # uploaded reference images\n```\n\nBack up the `data/` folder and you've backed up your entire library.\n\n## API\n\nThe frontend talks to a small REST API on the same origin. If you want to drive it from elsewhere (a CLI, another app, a script):\n\n| Method | Path | What it does |\n|---|---|---|\n| `GET` | `/api/tasks?view=media\\|favorites\\|trash\\|folder\u0026folder_id=…` | List tasks with their variants and presets. |\n| `GET` | `/api/tasks/:id` | One task. |\n| `PATCH` | `/api/tasks/:id` | Toggle favourite, trash, or move to folder. |\n| `POST` | `/api/generate` | Run a generation. Body: `{ prompt, character_preset_ids?, style_preset_id?, reference_image_path?, aspect, n, quality, folder_id? }`. |\n| `GET` | `/api/presets` | List active presets. |\n| `POST` | `/api/presets` | Create or fork a preset. |\n| `PATCH` | `/api/presets/:id` | Edit / archive a preset. |\n| `GET` | `/api/folders` | List folders. |\n| `POST` | `/api/folders` | Create a folder. |\n| `POST` | `/api/upload` | Upload a reference image. Multipart `file`. Returns `{ path }` for use in `reference_image_path`. |\n| `POST` | `/api/workshop/from-image` | Multipart `file`. Returns `{ prompt }`. |\n| `POST` | `/api/workshop/brainstorm` | Body: `{ dump }`. Returns `{ options: [{ title, prompt }, …] }`. |\n\n## Why local-first\n\nImage-gen platforms have a habit of shutting down, paywalling features, deleting libraries, or quietly retraining on your inputs. None of that touches a SQLite file on your laptop. If OpenAI ships a better model tomorrow, change one env var. If they sunset the API entirely, swap in another provider — the gallery, presets, and library outlive whichever model you used to fill them.\n\n## Contributing\n\nIssues and PRs welcome. This is a small project we built for ourselves and put in the open — no roadmap, no commitments. Fork freely.\n\n## License\n\nApache 2.0 — see [LICENSE](./LICENSE) and [NOTICE](./NOTICE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodependentai%2Feasel-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodependentai%2Feasel-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodependentai%2Feasel-ai/lists"}