Spaces:
Running
on
CPU Upgrade
title: Clapper
emoji: π¬
sdk: docker
colorFrom: gray
colorTo: gray
pinned: true
app_port: 3000
disable_embedding: false
hf_oauth: false
header: mini
short_description: π¬ Clapper
Introduction
π¬ Clapper is an open-source AI story visualization tool.
Clapper can interpret a screenplay and render it to storyboards, videos, voice, sound and music.
Please note however that the tool is at an early stage of development, for the moment it is not supposed to be really used by "normal" people (some features don't work, there are no tutorials etc).
Public alpha access
A public instance of Clapper is currently hosted on Hugging Face, you can try it at Clapper.app
Badges
Bounty Sponsors
Those generous sponsors are paying for code bounties:
Want to contribute?
For users or corporations
Sponsor specific features
If you wish to sponsor the project, help attract new developers, or promote a specific feature faster, you can open a bounty for a specific ticket (eg "fix music segment duration"
, "add support for Adobe Premiere Pro export"
, "finish .fbx integration"
) and open-source community members will be able to submit pull requests to solve them.
I propose to use Boss.dev to do this as it has lower fees than other platforms: boss.dev
If you submit (to pay) or take on (to earn) a bounty, please post a message in the GitHub thread and/or on Discord to help everyone coordinate around it.
I am currently working to add documentation to help onboard new developers, this should help new people taking on bounties.
For developers
Licence
Clapper is under a GPL v3 licence, see the LICENCE file for more information. This is a similar licensing to apps like ComfyUI or Blender.
Installation
Prerequisites
As a prerequisite you need to have git lfs installed (see the .gitattributes
file at the root of project):
git lfs install
Clapper has been tested with Node 20.9.*
.
To make sure you use this version, you can use NVM to activate it:
nvm use
If you find that Clapper is working with a more recent (stable) version of Node, or have a better version management to suggest, please open a ticket.
Installing and running the app
npm i
npm run dev
Making sure everything is working properly
There are no tests yet (I will create a ticket for that), but until then you can run the following command to make sure all the types are consistant and properly set:
npm run build
Code conventions
I haven't setup Prettier or a Linter yet.
Testing
@jbilcke-hf is working to add tests, and will also act as the "QA engineer".
Unit tests
Note: I've just added Vitest, we don't have tests yet.
npm run test
End-to-end tests
Note: I've just added Playwright, we don't have tests yet.
npx playwright test
Runs the end-to-end tests.
npx playwright test --ui
Starts the interactive UI mode.
npx playwright test --project=chromium
Runs the tests only on Desktop Chrome.
npx playwright test example
Runs the tests in a specific file.
npx playwright test --debug
Runs the tests in debug mode.
npx playwright codegen
Auto generate tests with Codegen.
We suggest that you begin by typing:
`npx playwright test`
Architecture
For convenience, you can access and inspect any of the services at runtime (in the browser's JS console) by typing useUI.getState(), useIO.getState()
etc