StoryForge 0.0.1b1__tar.gz

storyforge-0.0.1b1/LICENSE

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

storyforge-0.0.1b1/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: StoryForge
+Version: 0.0.1b1
+Summary: A cli app that generates short stories and AI images from prompts using a language model.
+Author: wom
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: google-genai>=1.23.0
+Requires-Dist: pillow>=11.2.1
+Requires-Dist: textual[syntax]>=0.54.1
+Requires-Dist: textual-dev>=0.00.1
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: platformdirs>=4.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.2.0; extra == "dev"
+Requires-Dist: ruff>=0.12.1; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+Requires-Dist: pre-commit>=3.6.0; extra == "dev"
+Requires-Dist: pip>=25.1.1; extra == "dev"
+Dynamic: license-file
+
+# StoryTime
+
+StoryTime is a Textual-based terminal application that uses Google's Gemini API to generate short stories and AI-generated images from user prompts. The app provides a simple TUI (Text User Interface) for entering prompts, confirming actions, and viewing results. When a user submits a prompt, the app generates a story and a corresponding image, saving the image to disk with a descriptive filename. The project is designed for creative exploration, rapid prototyping, and as a demonstration of integrating LLMs and generative image models into a modern Python TUI.
+
+**Features:**
+- Enter a custom story prompt and generate a short story using LLM.
+- Generate AI image illustrations for your story with flexible options:
+  - Use the story as context and describe the image yourself
+  - Break the story into logical chunks (paragraphs) and generate an image for each, with consistent style
+  - Skip image generation if desired
+- Save generated images to disk with creative, context-aware filenames.
+- All interactions are handled in a modern, responsive terminal UI.
+- Includes unit tests for core logic and easy setup with uv and pytest.
+
+## Setup
+
+This project uses [uv](https://github.com/astral-sh/uv) for fast Python virtual environment and dependency management.
+
+### 1. Create and activate a virtual environment
+
+```
+uv venv .venv
+source .venv/bin/activate
+```
+
+### 2. Install all dependencies (including dev dependencies) and the package in editable mode
+
+```
+pip install -e .
+```
+
+Or, if you want to use uv:
+
+```
+uv pip install .[dev]
+```
+
+## Running the Unit Tests
+
+```
+pytest
+```
+
+Or, if not in an activated venv:
+
+```
+.venv/bin/pytest
+```
+
+## Running the Program
+
+After installing in editable mode, run the app with:
+
+```
+storytime
+```
+
+This command is available as long as your virtual environment is activated.
+
+### CLI Usage
+
+You can use the command-line interface directly with the unified entry point:
+
+```bash
+storytime story "Tell me a story about a robot"
+```
+
+After generating a story, you will be prompted to choose how to generate illustrations:
+- Use the story as context and describe the image yourself
+- Break the story into logical chunks (paragraphs) and generate an image for each, with consistent style
+- Skip image generation
+
+You can also generate a standalone image:
+```bash
+storytime image "A beautiful sunset over mountains"
+```
+
+Or launch the interactive TUI:
+```bash
+storytime tui
+```
+
+## Tab Completion
+
+StoryTime CLI supports tab completion for commands, options, and arguments.
+
+### Quick Setup (Automatic)
+
+Enable tab completion with:
+
+```bash
+storytime --install-completion
+```
+
+**Note:** If you get an error about existing files, use the manual setup below.
+
+### Manual Setup
+
+If automatic installation doesn't work, you can set up completion manually for your shell:
+
+**Bash** (add to `~/.bashrc`):
+```bash
+eval "$(storytime --show-completion)"
+```
+
+**Zsh** (add to `~/.zshrc`):
+```bash
+eval "$(storytime --show-completion)"
+```
+
+**Fish** (add to `~/.config/fish/config.fish`):
+```bash
+storytime --show-completion | source
+```
+
+After adding the line to your shell configuration, restart your terminal or run:
+```bash
+source ~/.bashrc  # for bash
+source ~/.zshrc   # for zsh
+```
+
+### Using Tab Completion
+
+Once enabled, you can use tab completion for:
+
+- **Commands**: `storytime <TAB>` shows available commands (`story`, `image`, `tui`)
+- **Options**: `storytime story --<TAB>` shows options like `--output-dir`, `--verbose`, etc.
+- **Help**: Use `storytime <command> --help` to see all available options
+
+## Editing and Debugging
+
+- All source code is in the `storytime/` package. When editing or adding files, use package imports (e.g., `from storytime.gemini_backend import GeminiBackend`).
+- To add a new backend, create a new file in `storytime/` and implement the `LLMBackend` interface.
+- To debug, you can add print statements or use a debugger in any module in the `storytime/` package.
+- After making changes, rerun the tests with `pytest` to ensure everything works.
+
+## Adding New Dependencies
+
+- To add a new main (runtime) dependency:
+
+```
+uv pip install <package>
+```
+
+- To add a new dev (test/tooling) dependency:
+
+```
+uv pip install --extra dev <package>
+```
+
+- After adding dependencies, uv will update your `pyproject.toml` and `uv.lock` automatically.
+
+## Notes
+- Make sure you have a valid `GEMINI_API_KEY` in your environment before running the program.
+- The TUI requires a terminal that supports Textual applications.

storyforge-0.0.1b1/README.md

@@ -0,0 +1,155 @@
+# StoryTime
+
+StoryTime is a Textual-based terminal application that uses Google's Gemini API to generate short stories and AI-generated images from user prompts. The app provides a simple TUI (Text User Interface) for entering prompts, confirming actions, and viewing results. When a user submits a prompt, the app generates a story and a corresponding image, saving the image to disk with a descriptive filename. The project is designed for creative exploration, rapid prototyping, and as a demonstration of integrating LLMs and generative image models into a modern Python TUI.
+
+**Features:**
+- Enter a custom story prompt and generate a short story using LLM.
+- Generate AI image illustrations for your story with flexible options:
+  - Use the story as context and describe the image yourself
+  - Break the story into logical chunks (paragraphs) and generate an image for each, with consistent style
+  - Skip image generation if desired
+- Save generated images to disk with creative, context-aware filenames.
+- All interactions are handled in a modern, responsive terminal UI.
+- Includes unit tests for core logic and easy setup with uv and pytest.
+
+## Setup
+
+This project uses [uv](https://github.com/astral-sh/uv) for fast Python virtual environment and dependency management.
+
+### 1. Create and activate a virtual environment
+
+```
+uv venv .venv
+source .venv/bin/activate
+```
+
+### 2. Install all dependencies (including dev dependencies) and the package in editable mode
+
+```
+pip install -e .
+```
+
+Or, if you want to use uv:
+
+```
+uv pip install .[dev]
+```
+
+## Running the Unit Tests
+
+```
+pytest
+```
+
+Or, if not in an activated venv:
+
+```
+.venv/bin/pytest
+```
+
+## Running the Program
+
+After installing in editable mode, run the app with:
+
+```
+storytime
+```
+
+This command is available as long as your virtual environment is activated.
+
+### CLI Usage
+
+You can use the command-line interface directly with the unified entry point:
+
+```bash
+storytime story "Tell me a story about a robot"
+```
+
+After generating a story, you will be prompted to choose how to generate illustrations:
+- Use the story as context and describe the image yourself
+- Break the story into logical chunks (paragraphs) and generate an image for each, with consistent style
+- Skip image generation
+
+You can also generate a standalone image:
+```bash
+storytime image "A beautiful sunset over mountains"
+```
+
+Or launch the interactive TUI:
+```bash
+storytime tui
+```
+
+## Tab Completion
+
+StoryTime CLI supports tab completion for commands, options, and arguments.
+
+### Quick Setup (Automatic)
+
+Enable tab completion with:
+
+```bash
+storytime --install-completion
+```
+
+**Note:** If you get an error about existing files, use the manual setup below.
+
+### Manual Setup
+
+If automatic installation doesn't work, you can set up completion manually for your shell:
+
+**Bash** (add to `~/.bashrc`):
+```bash
+eval "$(storytime --show-completion)"
+```
+
+**Zsh** (add to `~/.zshrc`):
+```bash
+eval "$(storytime --show-completion)"
+```
+
+**Fish** (add to `~/.config/fish/config.fish`):
+```bash
+storytime --show-completion | source
+```
+
+After adding the line to your shell configuration, restart your terminal or run:
+```bash
+source ~/.bashrc  # for bash
+source ~/.zshrc   # for zsh
+```
+
+### Using Tab Completion
+
+Once enabled, you can use tab completion for:
+
+- **Commands**: `storytime <TAB>` shows available commands (`story`, `image`, `tui`)
+- **Options**: `storytime story --<TAB>` shows options like `--output-dir`, `--verbose`, etc.
+- **Help**: Use `storytime <command> --help` to see all available options
+
+## Editing and Debugging
+
+- All source code is in the `storytime/` package. When editing or adding files, use package imports (e.g., `from storytime.gemini_backend import GeminiBackend`).
+- To add a new backend, create a new file in `storytime/` and implement the `LLMBackend` interface.
+- To debug, you can add print statements or use a debugger in any module in the `storytime/` package.
+- After making changes, rerun the tests with `pytest` to ensure everything works.
+
+## Adding New Dependencies
+
+- To add a new main (runtime) dependency:
+
+```
+uv pip install <package>
+```
+
+- To add a new dev (test/tooling) dependency:
+
+```
+uv pip install --extra dev <package>
+```
+
+- After adding dependencies, uv will update your `pyproject.toml` and `uv.lock` automatically.
+
+## Notes
+- Make sure you have a valid `GEMINI_API_KEY` in your environment before running the program.
+- The TUI requires a terminal that supports Textual applications.

storyforge-0.0.1b1/StoryForge.egg-info/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: StoryForge
+Version: 0.0.1b1
+Summary: A cli app that generates short stories and AI images from prompts using a language model.
+Author: wom
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: google-genai>=1.23.0
+Requires-Dist: pillow>=11.2.1
+Requires-Dist: textual[syntax]>=0.54.1
+Requires-Dist: textual-dev>=0.00.1
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: platformdirs>=4.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.2.0; extra == "dev"
+Requires-Dist: ruff>=0.12.1; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+Requires-Dist: pre-commit>=3.6.0; extra == "dev"
+Requires-Dist: pip>=25.1.1; extra == "dev"
+Dynamic: license-file
+
+# StoryTime
+
+StoryTime is a Textual-based terminal application that uses Google's Gemini API to generate short stories and AI-generated images from user prompts. The app provides a simple TUI (Text User Interface) for entering prompts, confirming actions, and viewing results. When a user submits a prompt, the app generates a story and a corresponding image, saving the image to disk with a descriptive filename. The project is designed for creative exploration, rapid prototyping, and as a demonstration of integrating LLMs and generative image models into a modern Python TUI.
+
+**Features:**
+- Enter a custom story prompt and generate a short story using LLM.
+- Generate AI image illustrations for your story with flexible options:
+  - Use the story as context and describe the image yourself
+  - Break the story into logical chunks (paragraphs) and generate an image for each, with consistent style
+  - Skip image generation if desired
+- Save generated images to disk with creative, context-aware filenames.
+- All interactions are handled in a modern, responsive terminal UI.
+- Includes unit tests for core logic and easy setup with uv and pytest.
+
+## Setup
+
+This project uses [uv](https://github.com/astral-sh/uv) for fast Python virtual environment and dependency management.
+
+### 1. Create and activate a virtual environment
+
+```
+uv venv .venv
+source .venv/bin/activate
+```
+
+### 2. Install all dependencies (including dev dependencies) and the package in editable mode
+
+```
+pip install -e .
+```
+
+Or, if you want to use uv:
+
+```
+uv pip install .[dev]
+```
+
+## Running the Unit Tests
+
+```
+pytest
+```
+
+Or, if not in an activated venv:
+
+```
+.venv/bin/pytest
+```
+
+## Running the Program
+
+After installing in editable mode, run the app with:
+
+```
+storytime
+```
+
+This command is available as long as your virtual environment is activated.
+
+### CLI Usage
+
+You can use the command-line interface directly with the unified entry point:
+
+```bash
+storytime story "Tell me a story about a robot"
+```
+
+After generating a story, you will be prompted to choose how to generate illustrations:
+- Use the story as context and describe the image yourself
+- Break the story into logical chunks (paragraphs) and generate an image for each, with consistent style
+- Skip image generation
+
+You can also generate a standalone image:
+```bash
+storytime image "A beautiful sunset over mountains"
+```
+
+Or launch the interactive TUI:
+```bash
+storytime tui
+```
+
+## Tab Completion
+
+StoryTime CLI supports tab completion for commands, options, and arguments.
+
+### Quick Setup (Automatic)
+
+Enable tab completion with:
+
+```bash
+storytime --install-completion
+```
+
+**Note:** If you get an error about existing files, use the manual setup below.
+
+### Manual Setup
+
+If automatic installation doesn't work, you can set up completion manually for your shell:
+
+**Bash** (add to `~/.bashrc`):
+```bash
+eval "$(storytime --show-completion)"
+```
+
+**Zsh** (add to `~/.zshrc`):
+```bash
+eval "$(storytime --show-completion)"
+```
+
+**Fish** (add to `~/.config/fish/config.fish`):
+```bash
+storytime --show-completion | source
+```
+
+After adding the line to your shell configuration, restart your terminal or run:
+```bash
+source ~/.bashrc  # for bash
+source ~/.zshrc   # for zsh
+```
+
+### Using Tab Completion
+
+Once enabled, you can use tab completion for:
+
+- **Commands**: `storytime <TAB>` shows available commands (`story`, `image`, `tui`)
+- **Options**: `storytime story --<TAB>` shows options like `--output-dir`, `--verbose`, etc.
+- **Help**: Use `storytime <command> --help` to see all available options
+
+## Editing and Debugging
+
+- All source code is in the `storytime/` package. When editing or adding files, use package imports (e.g., `from storytime.gemini_backend import GeminiBackend`).
+- To add a new backend, create a new file in `storytime/` and implement the `LLMBackend` interface.
+- To debug, you can add print statements or use a debugger in any module in the `storytime/` package.
+- After making changes, rerun the tests with `pytest` to ensure everything works.
+
+## Adding New Dependencies
+
+- To add a new main (runtime) dependency:
+
+```
+uv pip install <package>
+```
+
+- To add a new dev (test/tooling) dependency:
+
+```
+uv pip install --extra dev <package>
+```
+
+- After adding dependencies, uv will update your `pyproject.toml` and `uv.lock` automatically.
+
+## Notes
+- Make sure you have a valid `GEMINI_API_KEY` in your environment before running the program.
+- The TUI requires a terminal that supports Textual applications.

storyforge-0.0.1b1/StoryForge.egg-info/SOURCES.txt

@@ -0,0 +1,21 @@
+LICENSE
+README.md
+pyproject.toml
+StoryForge.egg-info/PKG-INFO
+StoryForge.egg-info/SOURCES.txt
+StoryForge.egg-info/dependency_links.txt
+StoryForge.egg-info/entry_points.txt
+StoryForge.egg-info/requires.txt
+StoryForge.egg-info/top_level.txt
+storytime/StoryTime.py
+storytime/__init__.py
+storytime/context.py
+storytime/gemini_backend.py
+storytime/llm_backend.py
+storytime/prompt.py
+tests/test_StoryTime.py
+tests/test_cli_integration.py
+tests/test_context.py
+tests/test_gemini_backend.py
+tests/test_llm_backend.py
+tests/test_prompt.py

storyforge-0.0.1b1/StoryForge.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

storyforge-0.0.1b1/StoryForge.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+storytime = storytime.StoryTime:app

storyforge-0.0.1b1/StoryForge.egg-info/requires.txt

@@ -0,0 +1,14 @@
+google-genai>=1.23.0
+pillow>=11.2.1
+textual[syntax]>=0.54.1
+textual-dev>=0.00.1
+typer>=0.9.0
+rich>=13.0.0
+platformdirs>=4.2.0
+
+[dev]
+pytest>=8.2.0
+ruff>=0.12.1
+mypy>=1.8.0
+pre-commit>=3.6.0
+pip>=25.1.1

storyforge-0.0.1b1/StoryForge.egg-info/top_level.txt

@@ -0,0 +1,6 @@
+storytime
+storytime_output_20250724_005450
+storytime_output_20250726_003900
+storytime_output_20250726_190755
+storytime_output_20250726_192619
+storytime_output_20250731_004946

storyforge-0.0.1b1/pyproject.toml

@@ -0,0 +1,102 @@
+[project]
+name = "StoryForge"
+version = "0.0.1b1"
+description = "A cli app that generates short stories and AI images from prompts using a language model."
+authors = [
+    { name = "wom" }
+]
+license = "MIT"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "google-genai>=1.23.0",
+    "pillow>=11.2.1",
+    "textual[syntax]>=0.54.1",
+    "textual-dev>=0.00.1",
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    "platformdirs>=4.2.0"
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.2.0",
+    "ruff>=0.12.1",
+    "mypy>=1.8.0",
+    "pre-commit>=3.6.0",
+    "pip>=25.1.1"
+]
+
+[project.scripts]
+storytime = "storytime.StoryTime:app"
+
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+include = ["storytime*"]
+exclude = ["data*", "tests*"]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+
+[tool.ruff.lint]
+select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    "I",  # isort
+    "B",  # flake8-bugbear
+    "C4", # flake8-comprehensions
+    "UP", # pyupgraDe
+]
+ignore = []
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = true
+warn_unused_configs = true
+# Start with basic checks, can be made stricter later
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+check_untyped_defs = true
+disallow_untyped_decorators = false
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_unreachable = true
+strict_equality = true
+show_error_codes = true
+
+# Ignore third-party libraries without type stubs
+[[tool.mypy.overrides]]
+module = [
+    "google.*",
+    "textual.*",
+    "PIL.*",
+]
+ignore_missing_imports = true
+
+# Allow gradual adoption for tests
+[[tool.mypy.overrides]]
+module = [
+    "tests.*",
+]
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+ignore_errors = true

storyforge-0.0.1b1/setup.cfg

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