sepia-cli 0.1.0__tar.gz

sepia_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yiğit Erdoğan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sepia_cli-0.1.0/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: sepia-cli
+Version: 0.1.0
+Summary: Describe a picture and watch it appear as colored text in a second terminal window.
+Keywords: ascii-art,cli,terminal,claude,image-generation,flux
+Author: Yiğit Erdoğan
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Artistic Software
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Dist: anthropic>=2.3.0
+Requires-Dist: numpy>=2.5.4
+Requires-Dist: pillow>=13.0.0
+Requires-Dist: platformdirs>=4.14.0
+Requires-Dist: prompt-toolkit>=3.0.53
+Requires-Dist: pydantic>=2.14.1
+Requires-Dist: python-dotenv>=1.2.4
+Requires-Dist: rich>=15.0.0
+Requires-Dist: torch>=2.14.1 ; extra == 'local'
+Requires-Dist: diffusers>=0.42.1 ; extra == 'local'
+Requires-Dist: transformers>=4.57 ; extra == 'local'
+Requires-Dist: accelerate>=1.10 ; extra == 'local'
+Requires-Dist: bitsandbytes>=0.50.2 ; sys_platform != 'darwin' and extra == 'local'
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/Yigtwxx/sepia
+Project-URL: Repository, https://github.com/Yigtwxx/sepia
+Project-URL: Issues, https://github.com/Yigtwxx/sepia/issues
+Provides-Extra: local
+Description-Content-Type: text/markdown
+
+# sepia
+
+Type a short request in your terminal and get a photograph painted in colored text characters in a second terminal window.
+
+<!-- demo gif -->
+
+```text
+› waterfall
+ ⏺ Painting a tall waterfall in a mossy gorge.
+   pollinations · 6.2s
+› mountains
+ ⏺ Adding snowy mountains behind the waterfall.
+   pollinations · 5.8s
+```
+
+Follow-up requests build on the same picture: "mountains" after "waterfall" gives the same waterfall with mountains behind it. `/new` starts over. sepia only makes pictures; it is not a chat assistant.
+
+## How it works
+
+```text
+prompt window                                                  viewer window
+-------------                                                  -------------
+"mountains" + earlier requests
+        |
+        v
+Claude (art director) -> English photo prompt, edit or new, one-line reply
+        |
+        v
+Pollinations web API ---- fails or rate limited ----> FLUX.2 [klein] 4B on your GPU
+        |                                                      |
+        +------------------------> PNG <-----------------------+
+                                    |
+                                    +--- path over a loopback socket --->  photo -> colored characters
+```
+
+1. **Direct.** Claude (`claude-haiku-5-5` at low effort by default) turns the request and the scene so far into a detailed English photo prompt written for symbol rendering: one clear subject, strong light, saturated color, no text. It also decides whether the request edits the current picture or starts a new one, and writes a one-sentence reply in the language you typed in. The reply comes back as structured output (JSON with a fixed schema).
+2. **Paint.** The prompt goes to [Pollinations](https://pollinations.ai) first. If the API fails or rate limits, sepia paints the picture locally with [FLUX.2 [klein] 4B](https://huggingface.co/black-forest-labs/FLUX.2-klein-4B) (Apache 2.0), if you installed the local extra. The picture is painted at the viewer window's aspect ratio.
+3. **Show.** The picture is saved as a PNG, and the viewer window is told where it is. The viewer stretches contrast, boosts saturation, crops the picture to the window, and draws every cell as one character whose density matches the brightness, in 24-bit color where the terminal supports it (256 colors otherwise). Resizing the window redraws the picture without new API calls.
+
+The two windows are two processes that talk over an authenticated loopback socket (see [SECURITY.md](SECURITY.md)).
+
+## Install
+
+You need Windows 10/11 or macOS, [uv](https://docs.astral.sh/uv/), and an [Anthropic API key](https://console.anthropic.com/). uv provides Python 3.12 if you do not have it.
+
+**API painting only** (small install, no GPU needed):
+
+```bash
+uv tool install sepia-cli
+```
+
+**With the local fallback model** (about 3 GB of packages plus a 16 GB model download):
+
+```bash
+# macOS (Apple Silicon)
+uv tool install "sepia-cli[local]"
+
+# Windows: CUDA builds of torch are not on PyPI, so point uv at the PyTorch index
+uv tool install "sepia-cli[local]" --index https://download.pytorch.org/whl/cu130 --index-strategy unsafe-best-match
+```
+
+Then download the model once:
+
+```bash
+sepia --download
+```
+
+## Usage
+
+```bash
+sepia
+```
+
+On the first run sepia asks for your Anthropic API key (hidden input) and saves it to the user config folder. The first request opens the viewer window; keep it next to the prompt window.
+
+| Command | What it does |
+| --- | --- |
+| `/new` | Start a fresh picture. The next request does not build on the old one. |
+| `/style [ink\|fill]` | `ink` colors the characters on the terminal's own background (made for dark backgrounds); `fill` also paints each cell's background, which works on any theme. Without an argument it switches to the other style. |
+| `/charset [classic\|symbols]` | `classic` uses 31 density levels of the ASCII-art alphabet (letters, digits, punctuation); `symbols` uses punctuation only. Without an argument it switches to the other set. |
+| `/help` | List the commands. |
+| `/exit` | Close sepia and the viewer window. `/quit`, `/q` and Ctrl+D do the same. |
+
+Up and down arrows walk the request history, and typing `/` completes commands. The bottom bar shows the model, the current style and charset, and whether the viewer window is connected (`●`) or not (`○`). If you close the viewer, the next request opens it again.
+
+Command-line flags:
+
+| Flag | What it does |
+| --- | --- |
+| `--download` | Download the local model (about 16 GB) from Hugging Face. Needs `sepia-cli[local]`. |
+| `--version` | Print the version. |
+| `--help` | Print usage. |
+
+The interface speaks English and Turkish. It follows the system language unless `SEPIA_LANG` is set.
+
+## Configuration
+
+sepia reads settings from the environment, then from `.env` in the current directory, then from `.env` in the user config folder. A value that is already set is never overridden by a later source. See [.env.example](.env.example).
+
+| Variable | Default | Meaning |
+| --- | --- | --- |
+| `ANTHROPIC_API_KEY` | none | Required. Asked for on the first run if missing and saved to the user config `.env`. |
+| `POLLINATIONS_KEY` | none | Optional free key from [enter.pollinations.ai](https://enter.pollinations.ai). Uses the keyed endpoint with `flux.2-klein-4b` and no logo. |
+| `SEPIA_MODEL` | `claude-haiku-5-5` | The art director model. `claude-sonnet-5-5` writes richer prompts at a higher price. |
+| `SEPIA_EFFORT` | `low` | Claude effort: `low`, `medium`, `high`, `xhigh` or `max`. |
+| `SEPIA_STYLE` | `ink` | Starting style: `ink` or `fill`. |
+| `SEPIA_CHARSET` | `classic` | Starting character set: `classic` or `symbols`. |
+| `SEPIA_IMAGE_MODEL` | `black-forest-labs/FLUX.2-klein-4B` | Hugging Face id of the local model. |
+| `SEPIA_LANG` | system language | Interface language: `en` or `tr`. Set it in the shell environment; it is read before the `.env` files load. |
+
+An invalid value for `SEPIA_EFFORT`, `SEPIA_STYLE` or `SEPIA_CHARSET` stops sepia at startup.
+
+The user config folder is `%LOCALAPPDATA%\sepia` on Windows and `~/Library/Application Support/sepia` on macOS. It holds the key file, the request history, and one folder per session with that session's pictures (`01.png`, `02.png`, ...). The newest 10 session folders are kept.
+
+## Painting backends
+
+| Backend | When it runs | Notes |
+| --- | --- | --- |
+| Pollinations, keyed (`gen.pollinations.ai`) | First, when `POLLINATIONS_KEY` is set | `flux.2-klein-4b`, no logo. |
+| Pollinations, keyless (`image.pollinations.ai`) | First without a key; second with a key | About one picture per 15 seconds, adds a small logo. Requests are sent with `private=true`. |
+| FLUX.2 [klein] 4B, local | When the API fails or rate limits | Needs `sepia-cli[local]` and `sepia --download`. |
+
+After a rate-limit or out-of-credit answer (HTTP 429 or 402), sepia skips that endpoint for 120 seconds instead of retrying it on every picture.
+
+The local model runs on CUDA, then Apple Silicon (MPS), then CPU, whichever is found first:
+
+- **CUDA:** the transformer and text encoder load in 4-bit (bitsandbytes nf4), about 5 GB of VRAM. On an RTX 4070 laptop GPU a 768x512 picture takes about 3 seconds.
+- **MPS:** bf16 weights without quantization, so it needs more memory than the CUDA path.
+- **CPU:** float32. It works, but slowly.
+
+The model loads on the first local picture, so that picture takes longer. Edits differ by backend: the local model repaints using the previous picture as a reference, while the API cannot see the previous picture and repaints from the full prompt with the scene's fixed seed, which keeps the composition close.
+
+## Cost
+
+| Part | Cost |
+| --- | --- |
+| Claude Haiku as art director | About $0.0003 per request with the default model and effort |
+| Pollinations | Free (keyless, or with the free key) |
+| Local model | Free, runs on your hardware |
+
+`SEPIA_MODEL=claude-sonnet-5-5` or a higher `SEPIA_EFFORT` costs more per request.
+
+## Platform notes
+
+**Windows.** The viewer opens as a new Windows Terminal window in focus mode, so there is no tab bar or title bar. It uses a `sepia` profile (6 pt Cascadia Mono, black background, no padding) that sepia writes as a Windows Terminal fragment to `%LOCALAPPDATA%\Microsoft\Windows Terminal\Fragments\sepia\sepia.json`. Your own `settings.json` is not touched; delete that folder to remove the profile. The small font fits several times more cells into the window, which gives the picture more detail. Without Windows Terminal, the viewer falls back to a plain console window.
+
+**macOS.** The viewer opens in a new Terminal.app window through `osascript`. The first time, macOS asks whether your terminal may control Terminal.app (Automation permission); allow it. Terminal.app cannot hide its title bar. Press ⌘- in the viewer window to shrink the font: the picture redraws with more cells and more detail.
+
+**Linux.** Not supported. The viewer window cannot be opened there.
+
+## Privacy
+
+What leaves your machine:
+
+- **To Anthropic:** your request, the earlier requests of the current scene, and the last generated prompt.
+- **To Pollinations:** the generated English prompt, the picture size and the seed. Your original request is not sent. Nothing goes to Pollinations when the picture is painted locally.
+- **To Hugging Face:** only the model download when you run `sepia --download`.
+
+Pictures, the request history and the API key file stay in the user config folder on your machine. sepia has no telemetry of its own.
+
+## Development
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the setup on Windows and macOS, the checks, and the commit and test conventions. The design is described in [docs/superpowers/specs/2026-10-28-sepia-design.md](docs/superpowers/specs/2026-10-28-sepia-design.md), and releases in [docs/releasing.md](docs/releasing.md).
+
+## License
+
+[MIT](LICENSE). The optional local model, FLUX.2 [klein] 4B, is published by Black Forest Labs under Apache 2.0 and is downloaded separately from Hugging Face.

sepia_cli-0.1.0/README.md

@@ -0,0 +1,167 @@
+# sepia
+
+Type a short request in your terminal and get a photograph painted in colored text characters in a second terminal window.
+
+<!-- demo gif -->
+
+```text
+› waterfall
+ ⏺ Painting a tall waterfall in a mossy gorge.
+   pollinations · 6.2s
+› mountains
+ ⏺ Adding snowy mountains behind the waterfall.
+   pollinations · 5.8s
+```
+
+Follow-up requests build on the same picture: "mountains" after "waterfall" gives the same waterfall with mountains behind it. `/new` starts over. sepia only makes pictures; it is not a chat assistant.
+
+## How it works
+
+```text
+prompt window                                                  viewer window
+-------------                                                  -------------
+"mountains" + earlier requests
+        |
+        v
+Claude (art director) -> English photo prompt, edit or new, one-line reply
+        |
+        v
+Pollinations web API ---- fails or rate limited ----> FLUX.2 [klein] 4B on your GPU
+        |                                                      |
+        +------------------------> PNG <-----------------------+
+                                    |
+                                    +--- path over a loopback socket --->  photo -> colored characters
+```
+
+1. **Direct.** Claude (`claude-haiku-5-5` at low effort by default) turns the request and the scene so far into a detailed English photo prompt written for symbol rendering: one clear subject, strong light, saturated color, no text. It also decides whether the request edits the current picture or starts a new one, and writes a one-sentence reply in the language you typed in. The reply comes back as structured output (JSON with a fixed schema).
+2. **Paint.** The prompt goes to [Pollinations](https://pollinations.ai) first. If the API fails or rate limits, sepia paints the picture locally with [FLUX.2 [klein] 4B](https://huggingface.co/black-forest-labs/FLUX.2-klein-4B) (Apache 2.0), if you installed the local extra. The picture is painted at the viewer window's aspect ratio.
+3. **Show.** The picture is saved as a PNG, and the viewer window is told where it is. The viewer stretches contrast, boosts saturation, crops the picture to the window, and draws every cell as one character whose density matches the brightness, in 24-bit color where the terminal supports it (256 colors otherwise). Resizing the window redraws the picture without new API calls.
+
+The two windows are two processes that talk over an authenticated loopback socket (see [SECURITY.md](SECURITY.md)).
+
+## Install
+
+You need Windows 10/11 or macOS, [uv](https://docs.astral.sh/uv/), and an [Anthropic API key](https://console.anthropic.com/). uv provides Python 3.12 if you do not have it.
+
+**API painting only** (small install, no GPU needed):
+
+```bash
+uv tool install sepia-cli
+```
+
+**With the local fallback model** (about 3 GB of packages plus a 16 GB model download):
+
+```bash
+# macOS (Apple Silicon)
+uv tool install "sepia-cli[local]"
+
+# Windows: CUDA builds of torch are not on PyPI, so point uv at the PyTorch index
+uv tool install "sepia-cli[local]" --index https://download.pytorch.org/whl/cu130 --index-strategy unsafe-best-match
+```
+
+Then download the model once:
+
+```bash
+sepia --download
+```
+
+## Usage
+
+```bash
+sepia
+```
+
+On the first run sepia asks for your Anthropic API key (hidden input) and saves it to the user config folder. The first request opens the viewer window; keep it next to the prompt window.
+
+| Command | What it does |
+| --- | --- |
+| `/new` | Start a fresh picture. The next request does not build on the old one. |
+| `/style [ink\|fill]` | `ink` colors the characters on the terminal's own background (made for dark backgrounds); `fill` also paints each cell's background, which works on any theme. Without an argument it switches to the other style. |
+| `/charset [classic\|symbols]` | `classic` uses 31 density levels of the ASCII-art alphabet (letters, digits, punctuation); `symbols` uses punctuation only. Without an argument it switches to the other set. |
+| `/help` | List the commands. |
+| `/exit` | Close sepia and the viewer window. `/quit`, `/q` and Ctrl+D do the same. |
+
+Up and down arrows walk the request history, and typing `/` completes commands. The bottom bar shows the model, the current style and charset, and whether the viewer window is connected (`●`) or not (`○`). If you close the viewer, the next request opens it again.
+
+Command-line flags:
+
+| Flag | What it does |
+| --- | --- |
+| `--download` | Download the local model (about 16 GB) from Hugging Face. Needs `sepia-cli[local]`. |
+| `--version` | Print the version. |
+| `--help` | Print usage. |
+
+The interface speaks English and Turkish. It follows the system language unless `SEPIA_LANG` is set.
+
+## Configuration
+
+sepia reads settings from the environment, then from `.env` in the current directory, then from `.env` in the user config folder. A value that is already set is never overridden by a later source. See [.env.example](.env.example).
+
+| Variable | Default | Meaning |
+| --- | --- | --- |
+| `ANTHROPIC_API_KEY` | none | Required. Asked for on the first run if missing and saved to the user config `.env`. |
+| `POLLINATIONS_KEY` | none | Optional free key from [enter.pollinations.ai](https://enter.pollinations.ai). Uses the keyed endpoint with `flux.2-klein-4b` and no logo. |
+| `SEPIA_MODEL` | `claude-haiku-5-5` | The art director model. `claude-sonnet-5-5` writes richer prompts at a higher price. |
+| `SEPIA_EFFORT` | `low` | Claude effort: `low`, `medium`, `high`, `xhigh` or `max`. |
+| `SEPIA_STYLE` | `ink` | Starting style: `ink` or `fill`. |
+| `SEPIA_CHARSET` | `classic` | Starting character set: `classic` or `symbols`. |
+| `SEPIA_IMAGE_MODEL` | `black-forest-labs/FLUX.2-klein-4B` | Hugging Face id of the local model. |
+| `SEPIA_LANG` | system language | Interface language: `en` or `tr`. Set it in the shell environment; it is read before the `.env` files load. |
+
+An invalid value for `SEPIA_EFFORT`, `SEPIA_STYLE` or `SEPIA_CHARSET` stops sepia at startup.
+
+The user config folder is `%LOCALAPPDATA%\sepia` on Windows and `~/Library/Application Support/sepia` on macOS. It holds the key file, the request history, and one folder per session with that session's pictures (`01.png`, `02.png`, ...). The newest 10 session folders are kept.
+
+## Painting backends
+
+| Backend | When it runs | Notes |
+| --- | --- | --- |
+| Pollinations, keyed (`gen.pollinations.ai`) | First, when `POLLINATIONS_KEY` is set | `flux.2-klein-4b`, no logo. |
+| Pollinations, keyless (`image.pollinations.ai`) | First without a key; second with a key | About one picture per 15 seconds, adds a small logo. Requests are sent with `private=true`. |
+| FLUX.2 [klein] 4B, local | When the API fails or rate limits | Needs `sepia-cli[local]` and `sepia --download`. |
+
+After a rate-limit or out-of-credit answer (HTTP 429 or 402), sepia skips that endpoint for 120 seconds instead of retrying it on every picture.
+
+The local model runs on CUDA, then Apple Silicon (MPS), then CPU, whichever is found first:
+
+- **CUDA:** the transformer and text encoder load in 4-bit (bitsandbytes nf4), about 5 GB of VRAM. On an RTX 4070 laptop GPU a 768x512 picture takes about 3 seconds.
+- **MPS:** bf16 weights without quantization, so it needs more memory than the CUDA path.
+- **CPU:** float32. It works, but slowly.
+
+The model loads on the first local picture, so that picture takes longer. Edits differ by backend: the local model repaints using the previous picture as a reference, while the API cannot see the previous picture and repaints from the full prompt with the scene's fixed seed, which keeps the composition close.
+
+## Cost
+
+| Part | Cost |
+| --- | --- |
+| Claude Haiku as art director | About $0.0003 per request with the default model and effort |
+| Pollinations | Free (keyless, or with the free key) |
+| Local model | Free, runs on your hardware |
+
+`SEPIA_MODEL=claude-sonnet-5-5` or a higher `SEPIA_EFFORT` costs more per request.
+
+## Platform notes
+
+**Windows.** The viewer opens as a new Windows Terminal window in focus mode, so there is no tab bar or title bar. It uses a `sepia` profile (6 pt Cascadia Mono, black background, no padding) that sepia writes as a Windows Terminal fragment to `%LOCALAPPDATA%\Microsoft\Windows Terminal\Fragments\sepia\sepia.json`. Your own `settings.json` is not touched; delete that folder to remove the profile. The small font fits several times more cells into the window, which gives the picture more detail. Without Windows Terminal, the viewer falls back to a plain console window.
+
+**macOS.** The viewer opens in a new Terminal.app window through `osascript`. The first time, macOS asks whether your terminal may control Terminal.app (Automation permission); allow it. Terminal.app cannot hide its title bar. Press ⌘- in the viewer window to shrink the font: the picture redraws with more cells and more detail.
+
+**Linux.** Not supported. The viewer window cannot be opened there.
+
+## Privacy
+
+What leaves your machine:
+
+- **To Anthropic:** your request, the earlier requests of the current scene, and the last generated prompt.
+- **To Pollinations:** the generated English prompt, the picture size and the seed. Your original request is not sent. Nothing goes to Pollinations when the picture is painted locally.
+- **To Hugging Face:** only the model download when you run `sepia --download`.
+
+Pictures, the request history and the API key file stay in the user config folder on your machine. sepia has no telemetry of its own.
+
+## Development
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the setup on Windows and macOS, the checks, and the commit and test conventions. The design is described in [docs/superpowers/specs/2026-10-28-sepia-design.md](docs/superpowers/specs/2026-10-28-sepia-design.md), and releases in [docs/releasing.md](docs/releasing.md).
+
+## License
+
+[MIT](LICENSE). The optional local model, FLUX.2 [klein] 4B, is published by Black Forest Labs under Apache 2.0 and is downloaded separately from Hugging Face.

sepia_cli-0.1.0/pyproject.toml

@@ -0,0 +1,128 @@
+[project]
+name = "sepia-cli"
+version = "0.1.0"
+description = "Describe a picture and watch it appear as colored text in a second terminal window."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+keywords = [
+    "ascii-art",
+    "cli",
+    "terminal",
+    "claude",
+    "image-generation",
+    "flux",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Artistic Software",
+    "Topic :: Multimedia :: Graphics",
+]
+dependencies = [
+    "anthropic>=2.3.0",
+    "numpy>=2.5.4",
+    "pillow>=13.0.0",
+    "platformdirs>=4.14.0",
+    "prompt-toolkit>=3.0.53",
+    "pydantic>=2.14.1",
+    "python-dotenv>=1.2.4",
+    "rich>=15.0.0",
+]
+
+[[project.authors]]
+name = "Yiğit Erdoğan"
+
+[project.optional-dependencies]
+local = [
+    "torch>=2.14.1",
+    "diffusers>=0.42.1",
+    "transformers>=4.57",
+    "accelerate>=1.10",
+    "bitsandbytes>=0.50.2; sys_platform != 'darwin'",
+]
+
+[project.urls]
+Homepage = "https://github.com/Yigtwxx/sepia"
+Repository = "https://github.com/Yigtwxx/sepia"
+Issues = "https://github.com/Yigtwxx/sepia/issues"
+
+[project.scripts]
+sepia = "sepia.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.12.1,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "sepia"
+
+[[tool.uv.sources.torch]]
+index = "pytorch-cuda"
+marker = "sys_platform != 'darwin'"
+
+[[tool.uv.index]]
+name = "pytorch-cuda"
+url = "https://download.pytorch.org/whl/cu130"
+explicit = true
+
+[tool.ruff]
+line-length = 88
+target-version = "py312"
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "W",
+    "I",
+    "UP",
+    "B",
+    "SIM",
+    "ANN",
+    "RUF",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["ANN"]
+"src/sepia/ui.py" = ["RUF001"]
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+files = ["src"]
+
+[[tool.mypy.overrides]]
+module = [
+    "diffusers",
+    "diffusers.*",
+]
+follow_imports = "skip"
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = [
+    "torch",
+    "torch.*",
+    "huggingface_hub",
+    "huggingface_hub.*",
+]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+filterwarnings = ["error::pytest.PytestUnhandledThreadExceptionWarning"]
+
+[dependency-groups]
+dev = [
+    "mypy>=2.4.1",
+    "pytest>=9.2.0",
+    "ruff>=0.17.3",
+]

sepia_cli-0.1.0/pyproject.toml.orig

@@ -0,0 +1,106 @@
+[project]
+name = "sepia-cli"
+version = "0.1.0"
+description = "Describe a picture and watch it appear as colored text in a second terminal window."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Yiğit Erdoğan" }]
+requires-python = ">=3.12"
+keywords = ["ascii-art", "cli", "terminal", "claude", "image-generation", "flux"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Artistic Software",
+    "Topic :: Multimedia :: Graphics",
+]
+dependencies = [
+    "anthropic>=2.3.0",
+    "numpy>=2.5.4",
+    "pillow>=13.0.0",
+    "platformdirs>=4.14.0",
+    "prompt-toolkit>=3.0.53",
+    "pydantic>=2.14.1",
+    "python-dotenv>=1.2.4",
+    "rich>=15.0.0",
+]
+
+[project.optional-dependencies]
+# The local fallback painter: FLUX.2 [klein] 4B on this machine's GPU (about 3 GB of
+# packages plus a 16 GB model). Without it sepia paints through the web API only.
+local = [
+    "torch>=2.14.1",
+    "diffusers>=0.42.1",
+    "transformers>=4.57",
+    "accelerate>=1.10",
+    "bitsandbytes>=0.50.2; sys_platform != 'darwin'",
+]
+
+[project.urls]
+Homepage = "https://github.com/Yigtwxx/sepia"
+Repository = "https://github.com/Yigtwxx/sepia"
+Issues = "https://github.com/Yigtwxx/sepia/issues"
+
+[project.scripts]
+sepia = "sepia.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.12.1,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "sepia"
+
+# CUDA builds of torch on Windows and Linux; macOS takes the PyPI build, which has MPS.
+[tool.uv.sources]
+torch = [{ index = "pytorch-cuda", marker = "sys_platform != 'darwin'" }]
+
+[[tool.uv.index]]
+name = "pytorch-cuda"
+url = "https://download.pytorch.org/whl/cu130"
+explicit = true
+
+[dependency-groups]
+dev = [
+    "mypy>=2.4.1",
+    "pytest>=9.2.0",
+    "ruff>=0.17.3",
+]
+
+[tool.ruff]
+line-length = 88
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM", "ANN", "RUF"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["ANN"]
+# The prompt window draws with typographic glyphs (› ⏺ ※ ·) on purpose.
+"src/sepia/ui.py" = ["RUF001"]
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+files = ["src"]
+
+# diffusers ships without type information; treat it as untyped.
+[[tool.mypy.overrides]]
+module = ["diffusers", "diffusers.*"]
+follow_imports = "skip"
+ignore_missing_imports = true
+
+# The local extra may not be installed (CI type-checks without it).
+[[tool.mypy.overrides]]
+module = ["torch", "torch.*", "huggingface_hub", "huggingface_hub.*"]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+filterwarnings = ["error::pytest.PytestUnhandledThreadExceptionWarning"]

sepia_cli-0.1.0/src/sepia/__init__.py

@@ -0,0 +1,3 @@
+"""sepia: prompts become colored symbol paintings in your terminal."""
+
+__version__ = "0.1.0"

sepia_cli-0.1.0/src/sepia/__main__.py

@@ -0,0 +1,3 @@
+from sepia.cli import main
+
+raise SystemExit(main())