anime-prompt-kit 0.1.0__tar.gz

anime_prompt_kit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 diaozxin007
+
+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.

anime_prompt_kit-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include templates.json index.js cli.js index.test.js package.json
+recursive-include tests *.py

anime_prompt_kit-0.1.0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: anime-prompt-kit
+Version: 0.1.0
+Summary: Local anime character prompt templates and composer with a Python API and CLI
+Author: diaozxin007
+License-Expression: MIT
+Project-URL: Homepage, https://ai-anime-generator.io/
+Project-URL: Documentation, https://ai-anime-generator.io/open-source
+Project-URL: Source, https://github.com/diaozxin007/anime-prompt-kit
+Project-URL: Issues, https://github.com/diaozxin007/anime-prompt-kit/issues
+Keywords: anime,prompts,character-design,templates
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Anime Prompt Kit
+
+Build editable anime character prompts from structured fields. Includes 12 original character concepts and dependency-free JavaScript and Python composers.
+
+Made for use with [AI Anime Generator](https://ai-anime-generator.io/) or your preferred image generator. This toolkit assembles text locally; it does not generate images or call an API.
+
+## Python package
+
+Requires Python 3.9 or later. Install from [PyPI](https://pypi.org/project/anime-prompt-kit/):
+
+```sh
+python -m pip install anime-prompt-kit
+anime-prompt-kit --list
+anime-prompt-kit sky-courier --setting "a snowy train station"
+python -m anime_prompt_kit moon-librarian
+```
+
+```python
+from anime_prompt_kit import compose_prompt, from_template, list_templates
+
+print(from_template("sky-courier", setting="a snowy train station"))
+print(compose_prompt(subject="adult explorer", setting="forest"))
+```
+
+The Python API and CLI run locally without dependencies, accounts or API keys.
+[Documentation and project overview](https://ai-anime-generator.io/open-source).
+
+## JavaScript quick start
+
+Requires Node.js 20 or later. No dependencies, account, or API key required.
+
+```sh
+git clone https://github.com/diaozxin007/anime-prompt-kit.git
+cd anime-prompt-kit
+node cli.js --list
+node cli.js sky-courier
+node cli.js sky-courier --setting "a snowy train station" --composition "full body character sheet"
+```
+
+Example output from `node cli.js sky-courier`:
+
+> adult courier with short silver hair and amber eyes, navy flight jacket and brass goggles, holding a folded map, floating harbor at sunrise, anime illustration, clean line art, soft cel shading, soft cinematic lighting, three-quarter portrait
+
+Copy the output into [AI Anime Generator](https://ai-anime-generator.io/) to generate an image. The website is a separate service with its own account, credit, and usage terms; running this kit is free.
+
+## Use in JavaScript
+
+```js
+import { composePrompt, fromTemplate } from './index.js';
+
+console.log(fromTemplate('moon-librarian', {
+  action: 'reading beside a window',
+  lighting: 'warm candlelight',
+}));
+
+console.log(composePrompt({
+  subject: 'adult explorer with dark curls and green eyes',
+  outfit: 'teal coat and leather satchel',
+  setting: 'a floating botanical garden',
+  style: 'anime illustration, soft cel shading',
+}));
+```
+
+Supported fields are `subject`, `outfit`, `action`, `setting`, `style`, `lighting`, and `composition`. Empty fields are omitted. Overrides replace the corresponding field without changing the stored template. Unknown template IDs and non-string field values throw an error.
+
+This project is currently distributed through GitHub; no npm install is required.
+
+## Character templates
+
+| ID | Concept |
+| --- | --- |
+| `sky-courier` | Sky courier |
+| `forest-botanist` | Forest botanist |
+| `moon-librarian` | Moon librarian |
+| `desert-mechanic` | Desert mechanic |
+| `rain-detective` | Rain detective |
+| `tea-alchemist` | Tea alchemist |
+| `snow-ranger` | Snow ranger |
+| `ocean-cartographer` | Ocean cartographer |
+| `rooftop-musician` | Rooftop musician |
+| `garden-guardian` | Garden guardian |
+| `star-engineer` | Star engineer |
+| `village-baker` | Village baker |
+
+The canonical templates live in [`templates.json`](./templates.json), so you can also copy and edit them without using JavaScript.
+
+## Keep a character recognizable
+
+1. Keep the `subject` and signature `outfit` fixed between prompts.
+2. Change one field at a time, such as `action` or `setting`.
+3. Keep a record of the model and settings used in your image generator.
+4. Where supported, use the same reference image to guide later generations.
+
+These are text starting points, not a guarantee of character consistency. Different models interpret prompts differently. The included templates have not been individually image-tested; no generated results or performance claims are implied.
+
+Python distribution data is copied from `templates.json`; the parity test checks both copies and all 12 JavaScript/Python outputs. Update both JSON files when adding templates.
+
+## Privacy
+
+The composer and CLI run locally. They have no network calls, tracking, or credentials. Following a website link opens a separate external service.
+
+## Development and contributions
+
+```sh
+npm test
+PYTHONPATH=python python3 -m unittest discover -s tests -v
+```
+
+Contributions are welcome: add original templates, improve examples, or report bugs through GitHub issues. Include the exact command and Node.js version for bug reports. Keep secrets and private prompts out of issues. Please use original character concepts and do not contribute copyrighted artwork or copied prompt collections.
+
+## License
+
+[MIT](./LICENSE), covering the code and included template text.

anime_prompt_kit-0.1.0/README.md

@@ -0,0 +1,113 @@
+# Anime Prompt Kit
+
+Build editable anime character prompts from structured fields. Includes 12 original character concepts and dependency-free JavaScript and Python composers.
+
+Made for use with [AI Anime Generator](https://ai-anime-generator.io/) or your preferred image generator. This toolkit assembles text locally; it does not generate images or call an API.
+
+## Python package
+
+Requires Python 3.9 or later. Install from [PyPI](https://pypi.org/project/anime-prompt-kit/):
+
+```sh
+python -m pip install anime-prompt-kit
+anime-prompt-kit --list
+anime-prompt-kit sky-courier --setting "a snowy train station"
+python -m anime_prompt_kit moon-librarian
+```
+
+```python
+from anime_prompt_kit import compose_prompt, from_template, list_templates
+
+print(from_template("sky-courier", setting="a snowy train station"))
+print(compose_prompt(subject="adult explorer", setting="forest"))
+```
+
+The Python API and CLI run locally without dependencies, accounts or API keys.
+[Documentation and project overview](https://ai-anime-generator.io/open-source).
+
+## JavaScript quick start
+
+Requires Node.js 20 or later. No dependencies, account, or API key required.
+
+```sh
+git clone https://github.com/diaozxin007/anime-prompt-kit.git
+cd anime-prompt-kit
+node cli.js --list
+node cli.js sky-courier
+node cli.js sky-courier --setting "a snowy train station" --composition "full body character sheet"
+```
+
+Example output from `node cli.js sky-courier`:
+
+> adult courier with short silver hair and amber eyes, navy flight jacket and brass goggles, holding a folded map, floating harbor at sunrise, anime illustration, clean line art, soft cel shading, soft cinematic lighting, three-quarter portrait
+
+Copy the output into [AI Anime Generator](https://ai-anime-generator.io/) to generate an image. The website is a separate service with its own account, credit, and usage terms; running this kit is free.
+
+## Use in JavaScript
+
+```js
+import { composePrompt, fromTemplate } from './index.js';
+
+console.log(fromTemplate('moon-librarian', {
+  action: 'reading beside a window',
+  lighting: 'warm candlelight',
+}));
+
+console.log(composePrompt({
+  subject: 'adult explorer with dark curls and green eyes',
+  outfit: 'teal coat and leather satchel',
+  setting: 'a floating botanical garden',
+  style: 'anime illustration, soft cel shading',
+}));
+```
+
+Supported fields are `subject`, `outfit`, `action`, `setting`, `style`, `lighting`, and `composition`. Empty fields are omitted. Overrides replace the corresponding field without changing the stored template. Unknown template IDs and non-string field values throw an error.
+
+This project is currently distributed through GitHub; no npm install is required.
+
+## Character templates
+
+| ID | Concept |
+| --- | --- |
+| `sky-courier` | Sky courier |
+| `forest-botanist` | Forest botanist |
+| `moon-librarian` | Moon librarian |
+| `desert-mechanic` | Desert mechanic |
+| `rain-detective` | Rain detective |
+| `tea-alchemist` | Tea alchemist |
+| `snow-ranger` | Snow ranger |
+| `ocean-cartographer` | Ocean cartographer |
+| `rooftop-musician` | Rooftop musician |
+| `garden-guardian` | Garden guardian |
+| `star-engineer` | Star engineer |
+| `village-baker` | Village baker |
+
+The canonical templates live in [`templates.json`](./templates.json), so you can also copy and edit them without using JavaScript.
+
+## Keep a character recognizable
+
+1. Keep the `subject` and signature `outfit` fixed between prompts.
+2. Change one field at a time, such as `action` or `setting`.
+3. Keep a record of the model and settings used in your image generator.
+4. Where supported, use the same reference image to guide later generations.
+
+These are text starting points, not a guarantee of character consistency. Different models interpret prompts differently. The included templates have not been individually image-tested; no generated results or performance claims are implied.
+
+Python distribution data is copied from `templates.json`; the parity test checks both copies and all 12 JavaScript/Python outputs. Update both JSON files when adding templates.
+
+## Privacy
+
+The composer and CLI run locally. They have no network calls, tracking, or credentials. Following a website link opens a separate external service.
+
+## Development and contributions
+
+```sh
+npm test
+PYTHONPATH=python python3 -m unittest discover -s tests -v
+```
+
+Contributions are welcome: add original templates, improve examples, or report bugs through GitHub issues. Include the exact command and Node.js version for bug reports. Keep secrets and private prompts out of issues. Please use original character concepts and do not contribute copyrighted artwork or copied prompt collections.
+
+## License
+
+[MIT](./LICENSE), covering the code and included template text.

anime_prompt_kit-0.1.0/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import { templates, fromTemplate } from './index.js';
+const args = process.argv.slice(2);
+const allowed = new Set(['subject', 'outfit', 'action', 'setting', 'style', 'lighting', 'composition']);
+try {
+  if (args.length === 0 || args[0] === '--help') {
+    console.log('Usage: node cli.js <template-id> [--field "value"]\n       node cli.js --list\nFields: ' + [...allowed].join(', '));
+  } else if (args[0] === '--list' && args.length === 1) {
+    console.log(templates.map(t => `${t.id}: ${t.name}`).join('\n'));
+  } else {
+    const overrides = {};
+    for (let i = 1; i < args.length; i += 2) {
+      const key = args[i].slice(2);
+      if (!args[i].startsWith('--') || !allowed.has(key) || args[i + 1] === undefined || args[i + 1].startsWith('--')) throw new Error(`Invalid option: ${args[i]}`);
+      overrides[key] = args[i + 1];
+    }
+    console.log(fromTemplate(args[0], overrides));
+  }
+} catch (error) {
+  console.error(error.message);
+  process.exitCode = 1;
+}

anime_prompt_kit-0.1.0/index.js

@@ -0,0 +1,16 @@
+import { readFileSync } from 'node:fs';
+export const templates = JSON.parse(readFileSync(new URL('./templates.json', import.meta.url), 'utf8'));
+const fields = ['subject', 'outfit', 'action', 'setting', 'style', 'lighting', 'composition'];
+export function composePrompt(options = {}) {
+  if (!options || typeof options !== 'object' || Array.isArray(options)) throw new TypeError('Expected a prompt options object');
+  for (const key of fields) {
+    if (options[key] !== undefined && typeof options[key] !== 'string') throw new TypeError(`${key} must be a string`);
+  }
+  return fields.map(key => options[key]?.trim()).filter(Boolean).join(', ');
+}
+export function fromTemplate(id, overrides = {}) {
+  const template = templates.find(item => item.id === id);
+  if (!template) throw new Error(`Unknown template: ${id}. Use --list to see available templates.`);
+  if (!overrides || typeof overrides !== 'object' || Array.isArray(overrides)) throw new TypeError('Expected an overrides object');
+  return composePrompt({ ...template, ...overrides });
+}

anime_prompt_kit-0.1.0/index.test.js

@@ -0,0 +1,32 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { composePrompt, fromTemplate, templates } from './index.js';
+test('all templates have unique IDs and produce complete prompts', () => {
+  assert.equal(templates.length, 12);
+  assert.equal(new Set(templates.map(t => t.id)).size, 12);
+  for (const t of templates) {
+    const result = fromTemplate(t.id);
+    for (const field of ['subject', 'outfit', 'action', 'setting', 'style', 'lighting', 'composition']) assert.ok(result.includes(t[field]));
+  }
+});
+test('overrides preserve identity and do not mutate templates', () => {
+  const original = fromTemplate('sky-courier');
+  const changed = fromTemplate('sky-courier', { setting: 'a winter station' });
+  assert.ok(changed.includes(templates[0].subject));
+  assert.ok(changed.includes('a winter station'));
+  assert.equal(fromTemplate('sky-courier'), original);
+});
+test('blank fields and invalid inputs', () => {
+  assert.equal(composePrompt({ subject: '  pilot ', setting: '' }), 'pilot');
+  assert.throws(() => fromTemplate('missing'), /Unknown template/);
+  assert.throws(() => composePrompt({ subject: 7 }), TypeError);
+  assert.throws(() => fromTemplate('sky-courier', null), TypeError);
+});
+test('CLI supports overrides and rejects incomplete or unknown flags', () => {
+  const run = (...args) => spawnSync(process.execPath, ['cli.js', ...args], { cwd: new URL('.', import.meta.url), encoding: 'utf8' });
+  assert.equal(run('--list').stdout.trim().split('\n').length, 12);
+  assert.ok(run('sky-courier', '--setting', 'winter station').stdout.includes('winter station'));
+  assert.equal(run('sky-courier', '--setting').status, 1);
+  assert.equal(run('sky-courier', '--unknown', 'x').status, 1);
+});

anime_prompt_kit-0.1.0/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "anime-prompt-kit",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "Dependency-free anime character prompt templates and composer",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "node --test",
+    "list": "node cli.js --list"
+  },
+  "license": "MIT",
+  "homepage": "https://ai-anime-generator.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/diaozxin007/anime-prompt-kit.git"
+  }
+}

anime_prompt_kit-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "anime-prompt-kit"
+version = "0.1.0"
+description = "Local anime character prompt templates and composer with a Python API and CLI"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "diaozxin007"}]
+keywords = ["anime", "prompts", "character-design", "templates"]
+classifiers = ["Programming Language :: Python :: 3", "Operating System :: OS Independent"]
+
+[project.urls]
+Homepage = "https://ai-anime-generator.io/"
+Documentation = "https://ai-anime-generator.io/open-source"
+Source = "https://github.com/diaozxin007/anime-prompt-kit"
+Issues = "https://github.com/diaozxin007/anime-prompt-kit/issues"
+
+[project.scripts]
+anime-prompt-kit = "anime_prompt_kit.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["python"]
+
+[tool.setuptools.package-data]
+anime_prompt_kit = ["templates.json"]

anime_prompt_kit-0.1.0/python/anime_prompt_kit/__init__.py

@@ -0,0 +1,37 @@
+"""Compose anime character prompts locally, without network access."""
+import json
+from importlib.resources import files
+from collections.abc import Mapping
+
+__version__ = "0.1.0"
+FIELDS = ("subject", "outfit", "action", "setting", "style", "lighting", "composition")
+
+
+def list_templates():
+    """Return fresh template dictionaries; callers cannot mutate stored templates."""
+    return json.loads(files(__package__).joinpath("templates.json").read_text(encoding="utf-8"))
+
+
+def compose_prompt(options=None, **fields):
+    """Join nonempty fields in a stable order. Keyword arguments override options."""
+    if options is None:
+        options = {}
+    if not isinstance(options, Mapping):
+        raise TypeError("Expected a prompt options mapping")
+    values = dict(options, **fields)
+    for key in FIELDS:
+        if key in values and not isinstance(values[key], str):
+            raise TypeError(f"{key} must be a string")
+    return ", ".join(values.get(key, "").strip() for key in FIELDS if values.get(key, "").strip())
+
+
+def from_template(template_id, overrides=None, **fields):
+    """Compose a named template, replacing any supplied fields."""
+    if overrides is None:
+        overrides = {}
+    if not isinstance(overrides, Mapping):
+        raise TypeError("Expected an overrides mapping")
+    template = next((item for item in list_templates() if item["id"] == template_id), None)
+    if template is None:
+        raise ValueError(f"Unknown template: {template_id}. Use --list to see available templates.")
+    return compose_prompt(dict(template, **overrides), **fields)

anime_prompt_kit-0.1.0/python/anime_prompt_kit/__main__.py

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

anime_prompt_kit-0.1.0/python/anime_prompt_kit/cli.py

@@ -0,0 +1,30 @@
+"""Command-line prompt composer."""
+import argparse
+from . import FIELDS, __version__, from_template, list_templates
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(description="Compose anime prompts locally; no API key required.")
+    parser.add_argument("template", nargs="?")
+    parser.add_argument("--list", action="store_true", help="List available templates")
+    parser.add_argument("--version", action="version", version=__version__)
+    for field in FIELDS:
+        parser.add_argument(f"--{field}")
+    args = parser.parse_args(argv)
+    overrides = {key: getattr(args, key) for key in FIELDS if getattr(args, key) is not None}
+    if args.list:
+        if args.template or overrides:
+            parser.error("--list cannot be combined with a template or overrides")
+        for item in list_templates():
+            print(f"{item['id']}: {item['name']}")
+        return 0
+    if not args.template:
+        if overrides:
+            parser.error("a template is required with field overrides")
+        parser.print_help()
+        return 0
+    try:
+        print(from_template(args.template, overrides))
+    except (ValueError, TypeError) as error:
+        parser.error(str(error))
+    return 0

anime_prompt_kit-0.1.0/python/anime_prompt_kit/templates.json

@@ -0,0 +1,134 @@
+[
+  {
+    "id": "sky-courier",
+    "name": "Sky courier",
+    "subject": "adult courier with short silver hair and amber eyes",
+    "outfit": "navy flight jacket and brass goggles",
+    "action": "holding a folded map",
+    "setting": "floating harbor at sunrise",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "forest-botanist",
+    "name": "Forest botanist",
+    "subject": "adult botanist with braided brown hair and green eyes",
+    "outfit": "linen coat and leather satchel",
+    "action": "examining a glowing leaf",
+    "setting": "quiet forest greenhouse",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "moon-librarian",
+    "name": "Moon librarian",
+    "subject": "adult librarian with long violet hair and round glasses",
+    "outfit": "indigo robe with embroidered stars",
+    "action": "carrying an open book",
+    "setting": "moonlit library",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "desert-mechanic",
+    "name": "Desert mechanic",
+    "subject": "adult mechanic with curly black hair and copper eyes",
+    "outfit": "sand-colored overalls and work gloves",
+    "action": "repairing a small robot",
+    "setting": "desert workshop",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "rain-detective",
+    "name": "Rain detective",
+    "subject": "adult detective with cropped blue hair and gray eyes",
+    "outfit": "charcoal raincoat",
+    "action": "holding a transparent umbrella",
+    "setting": "rainy city street",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "tea-alchemist",
+    "name": "Tea alchemist",
+    "subject": "adult alchemist with auburn hair and freckles",
+    "outfit": "sage apron over a cream shirt",
+    "action": "pouring tea into a glass cup",
+    "setting": "warm herbal shop",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "snow-ranger",
+    "name": "Snow ranger",
+    "subject": "adult ranger with white braids and brown eyes",
+    "outfit": "teal winter coat and wool scarf",
+    "action": "watching distant mountains",
+    "setting": "snow-covered trail",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "ocean-cartographer",
+    "name": "Ocean cartographer",
+    "subject": "adult cartographer with dark curls and hazel eyes",
+    "outfit": "white shirt and blue waistcoat",
+    "action": "drawing a sea chart",
+    "setting": "sunlit ship cabin",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "rooftop-musician",
+    "name": "Rooftop musician",
+    "subject": "adult musician with pink bobbed hair and dark eyes",
+    "outfit": "burgundy jacket and black trousers",
+    "action": "playing a violin",
+    "setting": "city rooftop at dusk",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "garden-guardian",
+    "name": "Garden guardian",
+    "subject": "adult guardian with dark green hair and golden eyes",
+    "outfit": "layered moss-colored cloak",
+    "action": "holding a wooden staff",
+    "setting": "overgrown stone garden",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "star-engineer",
+    "name": "Star engineer",
+    "subject": "adult engineer with short black hair and blue eyes",
+    "outfit": "orange utility suit",
+    "action": "inspecting a holographic diagram",
+    "setting": "orbital observatory",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "village-baker",
+    "name": "Village baker",
+    "subject": "adult baker with sandy hair and warm brown eyes",
+    "outfit": "cream apron and rolled-up sleeves",
+    "action": "carrying a basket of bread",
+    "setting": "cozy village bakery",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  }
+]

anime_prompt_kit-0.1.0/python/anime_prompt_kit.egg-info/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: anime-prompt-kit
+Version: 0.1.0
+Summary: Local anime character prompt templates and composer with a Python API and CLI
+Author: diaozxin007
+License-Expression: MIT
+Project-URL: Homepage, https://ai-anime-generator.io/
+Project-URL: Documentation, https://ai-anime-generator.io/open-source
+Project-URL: Source, https://github.com/diaozxin007/anime-prompt-kit
+Project-URL: Issues, https://github.com/diaozxin007/anime-prompt-kit/issues
+Keywords: anime,prompts,character-design,templates
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Anime Prompt Kit
+
+Build editable anime character prompts from structured fields. Includes 12 original character concepts and dependency-free JavaScript and Python composers.
+
+Made for use with [AI Anime Generator](https://ai-anime-generator.io/) or your preferred image generator. This toolkit assembles text locally; it does not generate images or call an API.
+
+## Python package
+
+Requires Python 3.9 or later. Install from [PyPI](https://pypi.org/project/anime-prompt-kit/):
+
+```sh
+python -m pip install anime-prompt-kit
+anime-prompt-kit --list
+anime-prompt-kit sky-courier --setting "a snowy train station"
+python -m anime_prompt_kit moon-librarian
+```
+
+```python
+from anime_prompt_kit import compose_prompt, from_template, list_templates
+
+print(from_template("sky-courier", setting="a snowy train station"))
+print(compose_prompt(subject="adult explorer", setting="forest"))
+```
+
+The Python API and CLI run locally without dependencies, accounts or API keys.
+[Documentation and project overview](https://ai-anime-generator.io/open-source).
+
+## JavaScript quick start
+
+Requires Node.js 20 or later. No dependencies, account, or API key required.
+
+```sh
+git clone https://github.com/diaozxin007/anime-prompt-kit.git
+cd anime-prompt-kit
+node cli.js --list
+node cli.js sky-courier
+node cli.js sky-courier --setting "a snowy train station" --composition "full body character sheet"
+```
+
+Example output from `node cli.js sky-courier`:
+
+> adult courier with short silver hair and amber eyes, navy flight jacket and brass goggles, holding a folded map, floating harbor at sunrise, anime illustration, clean line art, soft cel shading, soft cinematic lighting, three-quarter portrait
+
+Copy the output into [AI Anime Generator](https://ai-anime-generator.io/) to generate an image. The website is a separate service with its own account, credit, and usage terms; running this kit is free.
+
+## Use in JavaScript
+
+```js
+import { composePrompt, fromTemplate } from './index.js';
+
+console.log(fromTemplate('moon-librarian', {
+  action: 'reading beside a window',
+  lighting: 'warm candlelight',
+}));
+
+console.log(composePrompt({
+  subject: 'adult explorer with dark curls and green eyes',
+  outfit: 'teal coat and leather satchel',
+  setting: 'a floating botanical garden',
+  style: 'anime illustration, soft cel shading',
+}));
+```
+
+Supported fields are `subject`, `outfit`, `action`, `setting`, `style`, `lighting`, and `composition`. Empty fields are omitted. Overrides replace the corresponding field without changing the stored template. Unknown template IDs and non-string field values throw an error.
+
+This project is currently distributed through GitHub; no npm install is required.
+
+## Character templates
+
+| ID | Concept |
+| --- | --- |
+| `sky-courier` | Sky courier |
+| `forest-botanist` | Forest botanist |
+| `moon-librarian` | Moon librarian |
+| `desert-mechanic` | Desert mechanic |
+| `rain-detective` | Rain detective |
+| `tea-alchemist` | Tea alchemist |
+| `snow-ranger` | Snow ranger |
+| `ocean-cartographer` | Ocean cartographer |
+| `rooftop-musician` | Rooftop musician |
+| `garden-guardian` | Garden guardian |
+| `star-engineer` | Star engineer |
+| `village-baker` | Village baker |
+
+The canonical templates live in [`templates.json`](./templates.json), so you can also copy and edit them without using JavaScript.
+
+## Keep a character recognizable
+
+1. Keep the `subject` and signature `outfit` fixed between prompts.
+2. Change one field at a time, such as `action` or `setting`.
+3. Keep a record of the model and settings used in your image generator.
+4. Where supported, use the same reference image to guide later generations.
+
+These are text starting points, not a guarantee of character consistency. Different models interpret prompts differently. The included templates have not been individually image-tested; no generated results or performance claims are implied.
+
+Python distribution data is copied from `templates.json`; the parity test checks both copies and all 12 JavaScript/Python outputs. Update both JSON files when adding templates.
+
+## Privacy
+
+The composer and CLI run locally. They have no network calls, tracking, or credentials. Following a website link opens a separate external service.
+
+## Development and contributions
+
+```sh
+npm test
+PYTHONPATH=python python3 -m unittest discover -s tests -v
+```
+
+Contributions are welcome: add original templates, improve examples, or report bugs through GitHub issues. Include the exact command and Node.js version for bug reports. Keep secrets and private prompts out of issues. Please use original character concepts and do not contribute copyrighted artwork or copied prompt collections.
+
+## License
+
+[MIT](./LICENSE), covering the code and included template text.

anime_prompt_kit-0.1.0/python/anime_prompt_kit.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+LICENSE
+MANIFEST.in
+README.md
+cli.js
+index.js
+index.test.js
+package.json
+pyproject.toml
+templates.json
+python/anime_prompt_kit/__init__.py
+python/anime_prompt_kit/__main__.py
+python/anime_prompt_kit/cli.py
+python/anime_prompt_kit/templates.json
+python/anime_prompt_kit.egg-info/PKG-INFO
+python/anime_prompt_kit.egg-info/SOURCES.txt
+python/anime_prompt_kit.egg-info/dependency_links.txt
+python/anime_prompt_kit.egg-info/entry_points.txt
+python/anime_prompt_kit.egg-info/top_level.txt
+tests/test_python.py

anime_prompt_kit-0.1.0/python/anime_prompt_kit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

anime_prompt_kit-0.1.0/python/anime_prompt_kit.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+anime-prompt-kit = anime_prompt_kit.cli:main

anime_prompt_kit-0.1.0/python/anime_prompt_kit.egg-info/top_level.txt

@@ -0,0 +1 @@
+anime_prompt_kit

anime_prompt_kit-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

anime_prompt_kit-0.1.0/templates.json

@@ -0,0 +1,134 @@
+[
+  {
+    "id": "sky-courier",
+    "name": "Sky courier",
+    "subject": "adult courier with short silver hair and amber eyes",
+    "outfit": "navy flight jacket and brass goggles",
+    "action": "holding a folded map",
+    "setting": "floating harbor at sunrise",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "forest-botanist",
+    "name": "Forest botanist",
+    "subject": "adult botanist with braided brown hair and green eyes",
+    "outfit": "linen coat and leather satchel",
+    "action": "examining a glowing leaf",
+    "setting": "quiet forest greenhouse",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "moon-librarian",
+    "name": "Moon librarian",
+    "subject": "adult librarian with long violet hair and round glasses",
+    "outfit": "indigo robe with embroidered stars",
+    "action": "carrying an open book",
+    "setting": "moonlit library",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "desert-mechanic",
+    "name": "Desert mechanic",
+    "subject": "adult mechanic with curly black hair and copper eyes",
+    "outfit": "sand-colored overalls and work gloves",
+    "action": "repairing a small robot",
+    "setting": "desert workshop",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "rain-detective",
+    "name": "Rain detective",
+    "subject": "adult detective with cropped blue hair and gray eyes",
+    "outfit": "charcoal raincoat",
+    "action": "holding a transparent umbrella",
+    "setting": "rainy city street",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "tea-alchemist",
+    "name": "Tea alchemist",
+    "subject": "adult alchemist with auburn hair and freckles",
+    "outfit": "sage apron over a cream shirt",
+    "action": "pouring tea into a glass cup",
+    "setting": "warm herbal shop",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "snow-ranger",
+    "name": "Snow ranger",
+    "subject": "adult ranger with white braids and brown eyes",
+    "outfit": "teal winter coat and wool scarf",
+    "action": "watching distant mountains",
+    "setting": "snow-covered trail",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "ocean-cartographer",
+    "name": "Ocean cartographer",
+    "subject": "adult cartographer with dark curls and hazel eyes",
+    "outfit": "white shirt and blue waistcoat",
+    "action": "drawing a sea chart",
+    "setting": "sunlit ship cabin",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "rooftop-musician",
+    "name": "Rooftop musician",
+    "subject": "adult musician with pink bobbed hair and dark eyes",
+    "outfit": "burgundy jacket and black trousers",
+    "action": "playing a violin",
+    "setting": "city rooftop at dusk",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "garden-guardian",
+    "name": "Garden guardian",
+    "subject": "adult guardian with dark green hair and golden eyes",
+    "outfit": "layered moss-colored cloak",
+    "action": "holding a wooden staff",
+    "setting": "overgrown stone garden",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "star-engineer",
+    "name": "Star engineer",
+    "subject": "adult engineer with short black hair and blue eyes",
+    "outfit": "orange utility suit",
+    "action": "inspecting a holographic diagram",
+    "setting": "orbital observatory",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  },
+  {
+    "id": "village-baker",
+    "name": "Village baker",
+    "subject": "adult baker with sandy hair and warm brown eyes",
+    "outfit": "cream apron and rolled-up sleeves",
+    "action": "carrying a basket of bread",
+    "setting": "cozy village bakery",
+    "style": "anime illustration, clean line art, soft cel shading",
+    "lighting": "soft cinematic lighting",
+    "composition": "three-quarter portrait"
+  }
+]

anime_prompt_kit-0.1.0/tests/test_python.py

@@ -0,0 +1,40 @@
+import json
+from pathlib import Path
+import subprocess
+import sys
+import unittest
+from anime_prompt_kit import compose_prompt, from_template, list_templates
+
+
+class PromptTests(unittest.TestCase):
+    def test_shared_templates(self):
+        root = Path(__file__).resolve().parents[1]
+        self.assertEqual(list_templates(), json.loads((root / "templates.json").read_text()))
+        self.assertEqual(len(list_templates()), 12)
+        for template in list_templates():
+            js = subprocess.check_output(["node", "cli.js", template["id"], "--setting", "a snowy station"], cwd=root, text=True).strip()
+            self.assertEqual(from_template(template["id"], setting="a snowy station"), js)
+
+    def test_overrides_do_not_mutate(self):
+        original = from_template("sky-courier")
+        self.assertIn("a snowy station", from_template("sky-courier", {"setting": "a snowy station"}))
+        self.assertEqual(from_template("sky-courier"), original)
+        items = list_templates()
+        items[0]["subject"] = "changed"
+        self.assertEqual(from_template("sky-courier"), original)
+
+    def test_validation(self):
+        self.assertEqual(compose_prompt(subject="  explorer  ", outfit="  ", setting="forest"), "explorer, forest")
+        for value in ([], 1, "text"):
+            with self.assertRaises(TypeError):
+                compose_prompt(value)
+        with self.assertRaises(TypeError):
+            compose_prompt(subject=None)
+        with self.assertRaises(ValueError):
+            from_template("missing")
+
+    def test_cli_errors(self):
+        for args in (["missing"], ["sky-courier", "--unknown", "x"], ["--list", "sky-courier"]):
+            result = subprocess.run([sys.executable, "-m", "anime_prompt_kit", *args], capture_output=True, text=True)
+            self.assertNotEqual(result.returncode, 0)
+            self.assertNotIn("Traceback", result.stderr)