kv-app/README.md

KV App - AI Video Flow

AI-powered video creation app with workflow automation, TikTok trending analysis, and video generation.

Features

• AI Workflow Builder: Create video workflows using AI agents (OpenCode, 34ai)
• TikTok Trending: Browse and analyze trending TikTok videos by region
• Video Recreation: Analyze trending videos and recreate with AI
• Settings Management: Configure API keys and preferences

Getting Started

Prerequisites

• Node.js 18+
• npm or yarn

Installation

npm install

Development

npm run dev

Open http://localhost:3000

Build

npm run build
npm start

Configuration

Go to Settings page to configure:

• OpenCode API Key: Get from opencode.ai
• 34ai API Key: Get from 34ai.net

Tech Stack

• Next.js 14
• React 18
• Tailwind CSS
• Zustand (state management)
• React Flow (workflow builder)

Project Structure

app/
├── api/
│   ├── opencode/     # OpenCode AI proxy
│   └── tiktok/       # TikTok trending API
├── settings/         # Settings page
├── shop/            # Shop page
├── trending/        # TikTok trending page
├── upload/          # Upload page
└── page.tsx         # Main home page

components/
├── Header.tsx       # Navigation header
└── tabs/
    └── CreateTab.tsx

lib/
├── api/
│   ├── api34ai.ts  # 34ai API client
│   └── opencode.ts  # OpenCode API client
├── context/
│   └── SettingsContext.tsx
└── types/
    └── index.ts

License

MIT