---

Mengapa OpenClip?

Fitur	Deskripsi
Conversational Production	Bikin video cuma lewat chat. OpenHer menanyakan informasi yang dibutuhkan secara bertahap, tidak overwhelm.
Multi-Agent Pipeline	Riset, penulisan, visual, audio, editing, dan review berjalan paralel dengan agent terspesialisasi.
Professional Quality	Font OFL bundled, EDL terstruktur, visual continuity, closed-loop QA, dan quality gate otomatis.
Cross-Platform Publish	Preflight check per platform, OAuth aman, dan publish langsung dari chat.
Modern TUI	Antarmuka terminal modern dengan Textual: real-time streaming, slash commands, leader key, dan theme switching.
AI Handle All	Cukup bilang "connect YouTube" atau "upload ke TikTok", OpenHer yang urus semua.

---

Quick Install

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/ahmdd4vd/OpenClip/main/scripts/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/ahmdd4vd/OpenClip/main/scripts/install.ps1 | iex

Setelah instalasi, verifikasi dengan:

openclip --help

---

Quick Start

1. Jalankan OpenClip

openclip

Ini akan launch TUI (Terminal UI) modern dengan Textual. Kamu akan melihat:

• Chat interface dengan OpenHer AI
• Sidebar dengan session list dan shortcuts
• Real-time streaming response
• Leader key (ctrl+space) untuk commands

2. Ngobrol dengan OpenHer

Ketik di chat:

Buat video tentang tips belajar Python

OpenHer akan menanyakan satu per satu:

• Durasi: 30 detik, 1 menit, atau 5 menit?
• Gaya: Santai, profesional, atau cinematic?
• Audience: Pemula, menengah, atau lanjut?
• Platform: YouTube, TikTok, Instagram, atau semua?

3. Connect Platform (OAuth)

Ketik di chat:

Connect YouTube

Atau pakai slash command:

/connect youtube

OpenHer akan:

1. Buka browser ke YouTube OAuth
2. Kamu login + approve
3. Token tersimpan aman (terenkripsi)
4. Notify: "YouTube connected! ✅"

Setelah itu, kamu bisa:

Upload video ke YouTube

OpenHer akan upload otomatis ke semua platform yang sudah di-connect.

4. Slash Commands

Command	Deskripsi
/model	Switch LLM model
/provider	Manage LLM providers
/session	Session management
/jobs	Job history
/approve	Approval gate
/compact	Compact session context
/connect	Connect platform (YouTube, TikTok, dll)
/disconnect	Disconnect platform
/platforms	List connected platforms
/theme	Switch theme (dark/light/high-contrast)
/update	Update OpenClip to latest version
/check-update	Check for available updates
/help	Show help
/exit	Exit TUI

5. Keyboard Shortcuts

Shortcut	Deskripsi
ctrl+c	Exit application
ctrl+p	Command palette
ctrl+space	Leader key (show shortcuts)
ctrl+n	New session
ctrl+l	List sessions
ctrl+m	Switch model
ctrl+b	Toggle sidebar
u	Check for updates (leader key)
esc	Interrupt generation

---

Contoh Percakapan

Kamu: Connect YouTube
OpenHer: Oke, saya siapkan koneksi ke YouTube...
         [Buka browser, kamu login ke Google]
OpenHer: YouTube connected! ✅

Kamu: Buat video tentang tips belajar Python
OpenHer: Oke! Durasi 1 menit, gaya santai, untuk pemula?
        Target platform: YouTube, TikTok, Instagram?
Kamu: Ya, semua platform

OpenHer: [Processing...]
         Video sudah siap!
         1. Script narasi — Sudah dibuat
         2. TTS voice — Menggunakan Edge TTS
         3. Aset video — Diambil dari Unsplash
         4. Render — Sudah selesai

Kamu: Upload ke semua platform
OpenHer: Upload ke YouTube... ✅
         Upload ke TikTok... ✅
         Upload ke Instagram... ✅

         Semua selesai!
         - YouTube: https://youtube.com/watch?v=xxx
         - TikTok: https://tiktok.com/@user/video/xxx
         - Instagram: https://instagram.com/reel/xxx

6. Update OpenClip

OpenClip akan otomatis cek update saat startup. Jika ada versi baru, kamu akan melihat notifikasi.

Untuk manual check:

/check-update

Untuk update:

/update

Atau via CLI:

openclip --check-update
openclip --update

---

Dokumentasi

Dokumen	Deskripsi
Installation Guide	Panduan instalasi detail per OS (Linux, Mac, Windows)
Setup Guide	Konfigurasi awal: API keys, OAuth, database, Redis, brand kit
Quickstart Tutorial	Tutorial 5 menit membuat video pertama
API Reference	Dokumentasi API untuk integrasi
Changelog	Riwayat perubahan versi

---

Requirements

• Python 3.12 atau lebih baru
• ffmpeg - untuk processing video/audio
• libsndfile1 - hanya untuk Linux (audio processing)
• Redis (opsional) - untuk production mode dengan Celery workers
• PostgreSQL (opsional) - untuk database production

---

Development

# Clone repo
git clone https://github.com/ahmdd4vd/OpenClip.git
cd OpenClip

# Install dependencies
make install

# Run tests
make test

# Run linter
make lint

# Format code
make format

# Type check
make typecheck

---

Browser / API

OpenClip juga bisa dijalankan sebagai API server:

# Start API server
uvicorn openclip.api.main:app --host 0.0.0.0 --port 8000

# Docs interaktif
open http://localhost:8000/docs

---

Tech Stack

• Language: Python 3.12+
• Orchestration: LangGraph (StateGraph)
• LLM Framework: LangChain + Anthropic / OpenAI / OpenRouter / custom
• API: FastAPI + Uvicorn
• Queue: Celery + Redis (production)
• Database: PostgreSQL (production, checkpointing)
• Video: MoviePy, FFmpeg
• TTS: edge-tts
• Audio: librosa, pydub, faster-whisper
• TUI: Textual (modern terminal UI)
• Observability: OpenTelemetry, Prometheus, Langfuse

---

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before submitting a PR.

1. Fork repo
2. Buat branch baru (git checkout -b feat/feature-keren)
3. Commit perubahan (git commit -m 'feat: tambah feature keren')
4. Push ke branch (git push origin feat/feature-keren)
5. Buka Pull Request

Pastikan:

• Semua test lolos: pytest tests/unit -q
• Lint bersih: ruff check src tests
• Type check bersih: mypy src

---

License

MIT License — by Huanime. See LICENSE for details.

---