flmkr 0.1.0__tar.gz

flmkr-0.1.0/.github/workflows/pr-validation.yml

@@ -0,0 +1,52 @@
+name: PR Validation
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: pytest tests/ -v --no-cov
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install ruff
+      - run: ruff check flmkr/ tests/
+      - run: ruff format --check flmkr/ tests/
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install mypy
+      - run: mypy flmkr/ --ignore-missing-imports
+
+  security:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install bandit
+      - run: bandit -r flmkr/ -ll --skip B101,B608

flmkr-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,24 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/flmkr
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

flmkr-0.1.0/.gitignore

@@ -0,0 +1,78 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+venv/
+ENV/
+env/
+.venv
+
+# pytest
+.pytest_cache/
+.coverage
+htmlcov/
+*.cover
+.hypothesis/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# FLMKR project
+flmkr-project/
+*.flmkr/
+.flmkr/
+assets/generated/
+assets/video/
+assets/audio/
+assets/images/
+renders/
+previews/
+*.mp4
+*.mov
+*.wav
+*.exr
+*.safetensors
+*.bin
+*.pt
+*.ckpt
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Secrets
+*.key
+*.pem
+*.env.local
+.env
+**/.env
+**/.env.*.local
+*.xml

flmkr-0.1.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.5
+Name: flmkr
+Version: 0.1.0
+Summary: AI Filmmaking Harness — an autonomous, terminal-native agent for planning, generating, validating, editing, and completing films.
+Project-URL: Homepage, https://github.com/dreampixelsforge/flmkr
+Project-URL: Repository, https://github.com/dreampixelsforge/flmkr
+Project-URL: Documentation, https://flmkr.dreampixelsforge.com
+Project-URL: Issues, https://github.com/dreampixelsforge/flmkr/issues
+Author: Dream Pixels Forge
+License-Expression: MIT
+Keywords: agent,ai,cli,film,production,video
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: aiohttp>=3.10
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: cattrs>=24.1
+Requires-Dist: click>=8.1.7
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0
+Requires-Dist: orjson>=3.10
+Requires-Dist: pathspec>=0.12
+Requires-Dist: pydantic-settings>=2.5
+Requires-Dist: pydantic>=2.8
+Requires-Dist: rich>=13.9
+Requires-Dist: sqlalchemy>=2.0.36
+Requires-Dist: structlog>=24.4
+Requires-Dist: tenacity>=9.0
+Requires-Dist: uuid-utils>=0.9
+Requires-Dist: watchdog>=5.0
+Provides-Extra: dev
+Requires-Dist: bandit>=1.7; extra == 'dev'
+Requires-Dist: coverage[toml]>=7.6; extra == 'dev'
+Requires-Dist: freezegun>=1.5; extra == 'dev'
+Requires-Dist: hypothesis>=6.120; extra == 'dev'
+Requires-Dist: mypy>=1.13; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.6; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: respx>=0.22; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Provides-Extra: redis
+Requires-Dist: arq>=0.26; extra == 'redis'
+Requires-Dist: redis>=5.2; extra == 'redis'
+Provides-Extra: ui
+Requires-Dist: textual>=1.0; extra == 'ui'
+Description-Content-Type: text/markdown
+
+# FLMKR — AI Filmmaking Harness
+
+An autonomous, terminal-native AI filmmaking agent that transforms creative ideas into complete audiovisual productions.
+
+## What It Is
+
+FLMKR is an **agent harness for filmmaking** — not a video generator, not a prompt engine, not a GUI wrapper. It's the environment that allows an autonomous agent to perform complex filmmaking work:
+
+- Plan productions from ideas, screenplays, or treatments
+- Create and maintain a Production Bible (characters, locations, style, continuity)
+- Generate shots through provider-agnostic adapters (Agnes, Kling, MiniMax, Runway)
+- Run QA at chunk/shot/scene levels with continuity checking
+- Recover from failures without restarting the entire production
+- Render final films with editorial assembly
+
+## Quick Start
+
+```bash
+# Install
+pip install -e ".[dev]"
+
+# Create a new film project
+flmkr create "A woman discovers her autonomous car is taking her somewhere she never asked to go."
+
+# Plan the production
+flmkr plan
+
+# Run production
+flmkr run
+
+# Check status
+flmkr status
+
+# Resume after interruption
+flmkr resume
+```
+
+## Architecture
+
+```
+CLI/TUI
+  ↓
+Producer Orchestrator
+  ↓
+Agents (Story, Character, Cinematography, Generation, QA, Editorial, Sound)
+  ↓
+Provider Adapters (Agnes, Kling, MiniMax, Runway)
+  ↓
+Production Bible (persistent state)
+  ↓
+Event Log (durable, resumable)
+```
+
+## Project Structure
+
+```
+flmkr/
+├── __init__.py      # Package entry
+├── cli.py           # Click CLI commands
+├── config.py        # Pydantic settings
+├── models.py        # Core data models (Bible, Shot, Scene, etc.)
+├── agents.py        # Agent framework
+├── providers.py     # Provider adapters
+├── orchestrator.py  # Producer/Orchestrator
+├── qa.py            # QA engine
+├── editorial.py     # Editorial/timeline engine
+├── project.py       # Project state container
+├── event_store.py   # SQLite event log
+├── events.py        # Event types
+├── exceptions.py    # Error types
+└── tui.py           # Rich terminal UI
+```
+
+## Requirements
+
+- Python 3.11+
+- SQLite (bundled with Python)
+- Internet connection for provider APIs
+
+## License
+
+MIT

flmkr-0.1.0/README.md

@@ -0,0 +1,82 @@
+# FLMKR — AI Filmmaking Harness
+
+An autonomous, terminal-native AI filmmaking agent that transforms creative ideas into complete audiovisual productions.
+
+## What It Is
+
+FLMKR is an **agent harness for filmmaking** — not a video generator, not a prompt engine, not a GUI wrapper. It's the environment that allows an autonomous agent to perform complex filmmaking work:
+
+- Plan productions from ideas, screenplays, or treatments
+- Create and maintain a Production Bible (characters, locations, style, continuity)
+- Generate shots through provider-agnostic adapters (Agnes, Kling, MiniMax, Runway)
+- Run QA at chunk/shot/scene levels with continuity checking
+- Recover from failures without restarting the entire production
+- Render final films with editorial assembly
+
+## Quick Start
+
+```bash
+# Install
+pip install -e ".[dev]"
+
+# Create a new film project
+flmkr create "A woman discovers her autonomous car is taking her somewhere she never asked to go."
+
+# Plan the production
+flmkr plan
+
+# Run production
+flmkr run
+
+# Check status
+flmkr status
+
+# Resume after interruption
+flmkr resume
+```
+
+## Architecture
+
+```
+CLI/TUI
+  ↓
+Producer Orchestrator
+  ↓
+Agents (Story, Character, Cinematography, Generation, QA, Editorial, Sound)
+  ↓
+Provider Adapters (Agnes, Kling, MiniMax, Runway)
+  ↓
+Production Bible (persistent state)
+  ↓
+Event Log (durable, resumable)
+```
+
+## Project Structure
+
+```
+flmkr/
+├── __init__.py      # Package entry
+├── cli.py           # Click CLI commands
+├── config.py        # Pydantic settings
+├── models.py        # Core data models (Bible, Shot, Scene, etc.)
+├── agents.py        # Agent framework
+├── providers.py     # Provider adapters
+├── orchestrator.py  # Producer/Orchestrator
+├── qa.py            # QA engine
+├── editorial.py     # Editorial/timeline engine
+├── project.py       # Project state container
+├── event_store.py   # SQLite event log
+├── events.py        # Event types
+├── exceptions.py    # Error types
+└── tui.py           # Rich terminal UI
+```
+
+## Requirements
+
+- Python 3.11+
+- SQLite (bundled with Python)
+- Internet connection for provider APIs
+
+## License
+
+MIT