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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
hawk_tui_video-1.0.0.tar.gz
(36.7 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hawk_tui_video-1.0.0.tar.gz.
File metadata
- Download URL: hawk_tui_video-1.0.0.tar.gz
- Upload date:
- Size: 36.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d06da5ef55ca7360c0f4bcafbd8a2a0b0cb9718238963dbcb9c9647ae6dd5c86
|
|
| MD5 |
96aec36729d8350c04e29b5a9fc2309f
|
|
| BLAKE2b-256 |
1abc54dab4a3649b89c42fa9e0548a9b726b72bf8dfd59f37f3f9a1f85b6ca57
|
File details
Details for the file hawk_tui_video-1.0.0-py3-none-any.whl.
File metadata
- Download URL: hawk_tui_video-1.0.0-py3-none-any.whl
- Upload date:
- Size: 18.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
482d4af0b7b724d1b516efff930039d8c262fe5c016ef0efa021d0e565835ce4
|
|
| MD5 |
ef35f538b682fd9f063074528218c3f5
|
|
| BLAKE2b-256 |
339de765d08011b300a82fa4d1877b4732e78c9297357834aa29a43a51296e56
|
