Skip to content

feat: add fal.ai provider support#1

Open
kocaemre wants to merge 1 commit into
oso95:mainfrom
kocaemre:feat/fal-ai-provider
Open

feat: add fal.ai provider support#1
kocaemre wants to merge 1 commit into
oso95:mainfrom
kocaemre:feat/fal-ai-provider

Conversation

@kocaemre

@kocaemre kocaemre commented Jul 9, 2026

Copy link
Copy Markdown

Summary

  • Add fal.ai as an alternative generation provider while keeping Higgsfield as the default path
  • Add fal.ai provider reference docs for scene stills, architecture-A legs, and architecture-B dives/connectors
  • Add a small fal_pipeline.py helper that uploads local conditioning frames, submits fal jobs, writes JSON, and downloads returned media
  • Update README/plugin metadata to mention fal.ai support

Test Plan

  • python3 -m py_compile plugins/scroll-world/skills/scroll-world/references/fal_pipeline.py
  • python3 plugins/scroll-world/skills/scroll-world/references/fal_pipeline.py --help
  • python3 plugins/scroll-world/skills/scroll-world/references/fal_pipeline.py image --prompt test --out-json /tmp/nope.json exits with the expected missing-FAL_KEY error
  • python3 -m json.tool plugins/scroll-world/.claude-plugin/plugin.json
  • python3 -m json.tool .claude-plugin/marketplace.json
  • git diff --check

Notes

  • I did not run a live fal.ai generation because that requires a funded FAL_KEY; the adapter is documented around the published fal endpoint schemas and keeps field names configurable (--end-field tail_image_url for models that need it).

@kocaemre
kocaemre force-pushed the feat/fal-ai-provider branch from 724cf92 to 7909477 Compare July 17, 2026 11:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant