Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Linux
Make narrated vertical shorts (TikTok, YouTube Shorts, Reels) with a coding agent and Remotion. 9+ agent skills, 20+ story flows, fact ledger, CC0 SFX.
Saved setup from 9 h ago
Will it work on Linux?
Heads-upIt also needs 1 setting in .env.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
git clone https://github.com/howznguyen/shorts-kit.git cd shorts-kit
Node.js LTS (no version pinned), Bun
# needs nvm: https://github.com/nvm-sh/nvm nvm install --lts curl -fsSL https://bun.sh/install | bash
Optional, add them when you need them: ELEVENLABS_API_KEY
cp .env.example .env
bun install
bun run dev
git clone https://github.com/howznguyen/shorts-kit.git
cd shorts-kit
bun install
For ElevenLabs, copy .env.example to .env and set ELEVENLABS_API_KEY.
For VieNeu (Vietnamese), install it once into a local Python env (needs uv):
uv venv --python 3.12 .venv-vieneu
uv pip install --python .venv-vieneu/bin/python vieneu
.venv-vieneu/bin/python scripts/lib/engines/vieneu_bridge.py --voices # downloads the model (~600 MB), lists voices
Then in narration.json: "voice": {"engine": "vieneu", "voice": "Thiện Minh"}. voice
is a preset name or the path to a 3–8 s .wav to clone (only a voice you have the
right to use).
To use your own recording instead of TTS, install whisper.cpp and download the model once (1.6 GB):
brew install whisper-cpp # macOS; on Linux or Windows build it from github.com/ggml-org/whisper.cpp
mkdir -p .cache/whisper && curl -L -o .cache/whisper/ggml-large-v3-turbo.bin \
https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo.bin
No reports for Linux yet.
GitManual AI Agent reads the 3 key files and writes a step-by-step guide for Linux. Once written, it's saved for everyone.