HawkTUI
Terminal-based TikTok video creator with AI image generation.
Generate images using custom Replicate models and assemble them into 9:16 TikTok videos with FFmpeg.
Installation
pip install hawktui
Requirements
- Python 3.11+
- FFmpeg (for video creation)
# macOS
brew install ffmpeg
# Ubuntu/Debian
sudo apt install ffmpeg
Setup
-
Get your API token from Replicate
-
Create a
.envfile in your project directory:
REPLICATE_API_TOKEN=r8_your_token_here
- Configure your models in
hawk/config.py
Usage
# Run the TUI
hawktui
# Or
hawk
Keyboard Shortcuts
| Key | Action |
|---|---|
↑/↓ |
Navigate |
Tab |
Switch panels |
Enter |
Select/Open |
Space |
Toggle image selection |
a |
Select all images |
v |
Create video |
b |
Browse folder |
d |
Delete selected |
1/2/3 |
Switch projects |
q |
Quit |
How It Works
- Select a project - Choose from your configured Replicate models
- Enter a prompt - Type your image generation prompt
- Generate - Press Enter to generate images via Replicate
- Select images - Use Space to select images for your video
- Create video - Press
vto assemble a TikTok-format video
Configuration
Edit hawk/config.py to add your own Replicate models:
PROJECTS = {
"my-project": Project(
name="My Project",
slug="my-project",
model="username/model-name",
trigger="TOK", # Optional trigger word
description="Description",
),
}
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for hawk-tui-video 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hawk_tui_video-1.0.0.tar.gz | 36.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hawk_tui_video-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 55.2 kB
Release files / hawk_tui_video-1.0.0.tar.gz
| Download URL | hawk_tui_video-1.0.0.tar.gz |
|---|---|
| Size | 36.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d06da5ef55ca7360c0f4bcafbd8a2a0b0cb9718238963dbcb9c9647ae6dd5c86
|
|
BLAKE2b-256 checksum How to use checksums |
1abc54dab4a3649b89c42fa9e0548a9b726b72bf8dfd59f37f3f9a1f85b6ca57
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.11
|
Release files / hawk_tui_video-1.0.0-py3-none-any.whl
| Download URL | hawk_tui_video-1.0.0-py3-none-any.whl |
|---|---|
| Size | 18.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
482d4af0b7b724d1b516efff930039d8c262fe5c016ef0efa021d0e565835ce4
|
|
BLAKE2b-256 checksum How to use checksums |
339de765d08011b300a82fa4d1877b4732e78c9297357834aa29a43a51296e56
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.11
|
