InkFrame

English | 中文

Local AI filmmaking workstation. A node-based canvas wires text, image, and video nodes through DashScope (wanx), Kling, and Gemini. Data and API keys stay on disk.

Status: alpha (v0.1.0-alpha.8). macOS + Windows, single Dart codebase.

Get started

Requirements: Flutter ≥ 3.41, Dart ≥ 3.11, PostgreSQL 17 binaries on disk. macOS also needs Xcode 16 + CocoaPods.

git clone https://github.com/KerroKapple/InkFrame.git
cd InkFrame
flutter pub get

# Run with fake providers — no API keys, no quota burn
INKFRAME_PG_BIN=/opt/homebrew/opt/postgresql@17/bin \
INKFRAME_FAKE_PROVIDERS=1 \
flutter run -d macos

For real generation, drop INKFRAME_FAKE_PROVIDERS and add keys in Settings → Providers. Keys go to Keychain / Credential Manager.

flutter analyze              # 0 warnings (CI uses --fatal-infos)
flutter test                 # full suite
flutter test --tags integration

Environment variables, key storage, and data-directory layout: see docs/ARCHITECTURE.md.

Documentation

• ROADMAP.md — what's shipped, what's next
• CONTRIBUTING.md — workflow, hooks, commit rules
• docs/ARCHITECTURE.md — DI, layers, error model, degradation
• docs/PROVIDER-API.md — adding a provider
• docs/DATABASE.md — schema and migrations
• docs/TESTING.md — TDD layering and mocks
• SECURITY.md — reporting and key handling

Reporting bugs

Open a GitHub issue or start a Discussion.

License

MIT