feedeas 0.1.0-alpha.1 → 0.1.0-alpha.3

package/.env.example

@@ -0,0 +1,15 @@
+# Feedeas Environment Variables
+
+# Gemini API Key (for 'imagine' command)
+# Get your API key at: https://aistudio.google.com/app/apikey
+GEMINI_API_KEY=your-gemini-api-key-here
+
+# Setup Instructions:
+# 1. Copy this file to .env
+# 2. Replace the placeholder value with your actual Gemini API key
+# 3. The CLI will automatically load this value
+#
+# Example:
+#   cp .env.example .env
+#   # Edit .env with your API key
+#   feedeas imagine "a beautiful sunset"

package/README.md

@@ -1,15 +1,141 @@
-# feedeas
+# Feedeas
 
-To install dependencies:
+**Feedeas** is an agentic video creation tool that allows you to programmatically create videos using JSON scene definitions. Perfect for automated content generation, social media posts, and AI-driven video workflows.
+
+## Features
+
+- 🎬 **Programmatic Video Creation** - Define scenes using simple JSON
+- 🎨 **AI Image Generation** - Built-in support for Google Imagen AI
+- 🖼️ **Rich Media Support** - Text, images, and audio with transitions
+- 🤖 **Agent-Friendly** - Designed for AI agents and automation
+- 🎯 **Interactive Editor** - Web-based UI for visual editing
+- ⚡ **Fast Rendering** - Powered by Playwright and FFmpeg
+
+## Quick Start
+
+### Installation
 
 ```bash
 bun install
+bun run build
+```
+
+### Basic Usage
+
+```bash
+# Create a scene template
+feedeas example basic > scene.json
+
+# Validate the scene
+feedeas validate scene.json
+
+# Open interactive editor
+feedeas edit
+
+# Render to video
+feedeas record --project scene.json
+```
+
+## Commands
+
+### Video Creation
+
+- `feedeas edit [dir]` - Start the interactive editor
+- `feedeas record` - Render scene to video
+- `feedeas snap <time>` - Take a snapshot at specific time
+- `feedeas validate <file>` - Validate scene JSON
+
+### AI Image Generation
+
+Generate images using Google's Imagen AI (via Gemini API):
+
+```bash
+# Setup (one-time): Get API key from https://aistudio.google.com/app/apikey
+export GEMINI_API_KEY="your-api-key"
+
+# Basic usage - saves to assets/mountain.png
+feedeas imagine "A serene mountain landscape"
+
+# Multiple images - saves to assets/pattern_1.png, pattern_2.png, etc.
+feedeas imagine "Abstract art" -n 4 -o pattern.png
+```
+
+**Images save to `./assets/` by default** - perfect for video workflows!
+
+**[📖 Full Imagine Command Documentation](./docs/IMAGINE_COMMAND.md)**
+
+### Scene Management
+
+- `feedeas example [type]` - Generate example scenes
+- `feedeas set-scene <file>` - Create/update scene programmatically
+- `feedeas inspect` - Inspect project assets
+- `feedeas schema` - Show entity schema information
+
+## Project Structure
+
+```
+your-project/
+├── scene_1.json          # Scene definition
+├── assets/               # Images, audio files
+│   ├── background.png
+│   ├── music.mp3
+│   └── ...
+└── output.mp4           # Generated video
+```
+
+## Scene File Format
+
+```json
+{
+  "meta": {
+    "width": 1080,
+    "height": 1350,
+    "duration": 5
+  },
+  "entities": [
+    {
+      "id": "text-1",
+      "type": "text",
+      "text": "Hello, World!",
+      "startTime": 0,
+      "duration": 5,
+      "x": 100,
+      "y": 500,
+      "fontSize": 80,
+      "color": "#ffffff",
+      "enter": { "type": "fade", "duration": 0.5 }
+    }
+  ]
+}
 ```
 
-To run:
+## Documentation
+
+- [Imagine Command Guide](./docs/IMAGINE_COMMAND.md) - AI image generation
+- Run `feedeas --help` for full CLI documentation
+- Run `feedeas <command> --help` for command-specific help
+
+## Development
 
 ```bash
-bun run index.ts
+# Run in development mode
+bun run dev
+
+# Build CLI and UI
+bun run build
+
+# Run CLI directly
+bun run feedeas
 ```
 
-This project was created using `bun init` in bun v1.2.2. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.
+## Requirements
+
+- [Bun](https://bun.sh) v1.2.2 or later
+- Node.js 20.19+ or 22.12+ (for Vite)
+- FFmpeg (for video rendering)
+- Gemini API key (for AI image generation) - Get free at https://aistudio.google.com/app/apikey
+
+## License
+
+This project was created using `bun init` in bun v1.2.2.
+

package/bun.lock

@@ -19,6 +19,7 @@
         "@vitejs/plugin-react": "^5.1.2",
         "autoprefixer": "^10.4.23",
         "bun-types": "^1.3.6",
+        "playwright": "^1.57.0",
         "postcss": "^8.5.6",
         "tailwindcss": "^4.1.18",
         "vite": "^7.3.1",
@@ -271,7 +272,7 @@
 
     "fraction.js": ["fraction.js@5.3.4", "", {}, "sha512-1X1NTtiJphryn/uLQz3whtY6jK3fTqoE3ohKs0tT+Ujr1W59oopxmoEh7Lu5p6vBaPbgoM0bzveAW4Qi5RyWDQ=="],
 
-    "fsevents": ["fsevents@2.3.3", "", { "os": "darwin" }, "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw=="],
+    "fsevents": ["fsevents@2.3.2", "", { "os": "darwin" }, "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA=="],
 
     "gensync": ["gensync@1.0.0-beta.2", "", {}, "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg=="],
 
@@ -337,6 +338,10 @@
 
     "picomatch": ["picomatch@4.0.3", "", {}, "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q=="],
 
+    "playwright": ["playwright@1.57.0", "", { "dependencies": { "playwright-core": "1.57.0" }, "optionalDependencies": { "fsevents": "2.3.2" }, "bin": { "playwright": "cli.js" } }, "sha512-ilYQj1s8sr2ppEJ2YVadYBN0Mb3mdo9J0wQ+UuDhzYqURwSoW4n1Xs5vs7ORwgDGmyEh33tRMeS8KhdkMoLXQw=="],
+
+    "playwright-core": ["playwright-core@1.57.0", "", { "bin": { "playwright-core": "cli.js" } }, "sha512-agTcKlMw/mjBWOnD6kFZttAAGHgi/Nw0CZ2o6JqWSbMlI219lAFLZZCyqByTsvVAJq5XA5H8cA6PrvBRpBWEuQ=="],
+
     "postcss": ["postcss@8.5.6", "", { "dependencies": { "nanoid": "^3.3.11", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg=="],
 
     "postcss-value-parser": ["postcss-value-parser@4.2.0", "", {}, "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ=="],
@@ -388,5 +393,37 @@
     "@tailwindcss/oxide-wasm32-wasi/@tybys/wasm-util": ["@tybys/wasm-util@0.10.1", "", { "dependencies": { "tslib": "^2.4.0" }, "bundled": true }, "sha512-9tTaPJLSiejZKx+Bmog4uSubteqTvFrVrURwkmHixBo0G4seD0zUxp98E1DzUBJxLQ3NPwXrGKDiVjwx/DpPsg=="],
 
     "@tailwindcss/oxide-wasm32-wasi/tslib": ["tslib@2.8.1", "", { "bundled": true }, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "rollup/fsevents": ["fsevents@2.3.3", "", { "os": "darwin" }, "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw=="],
+
+    "vite/fsevents": ["fsevents@2.3.3", "", { "os": "darwin" }, "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@emnapi/core/@emnapi/wasi-threads": ["@emnapi/wasi-threads@1.1.0", "", { "dependencies": { "tslib": "^2.4.0" }, "bundled": true }, "sha512-WI0DdZ8xFSbgMjR1sFsKABJ/C5OnRrjT06JXbZKexJGrDuPTzZdDYfFlsgcCXCyf+suG5QU2e/y1Wo2V/OapLQ=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@emnapi/core/tslib": ["tslib@2.8.1", "", { "bundled": true }, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@emnapi/runtime/tslib": ["tslib@2.8.1", "", { "bundled": true }, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@emnapi/wasi-threads/tslib": ["tslib@2.8.1", "", { "bundled": true }, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@napi-rs/wasm-runtime/@emnapi/core": ["@emnapi/core@1.8.1", "", { "dependencies": { "@emnapi/wasi-threads": "1.1.0", "tslib": "^2.4.0" }, "bundled": true }, "sha512-AvT9QFpxK0Zd8J0jopedNm+w/2fIzvtPKPjqyw9jwvBaReTTqPBk9Hixaz7KbjimP+QNz605/XnjFcDAL2pqBg=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@napi-rs/wasm-runtime/@emnapi/runtime": ["@emnapi/runtime@1.8.1", "", { "dependencies": { "tslib": "^2.4.0" }, "bundled": true }, "sha512-mehfKSMWjjNol8659Z8KxEMrdSJDDot5SXMq00dM8BN4o+CLNXQ0xH2V7EchNHV4RmbZLmmPdEaXZc5H2FXmDg=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@napi-rs/wasm-runtime/@tybys/wasm-util": ["@tybys/wasm-util@0.10.1", "", { "dependencies": { "tslib": "^2.4.0" }, "bundled": true }, "sha512-9tTaPJLSiejZKx+Bmog4uSubteqTvFrVrURwkmHixBo0G4seD0zUxp98E1DzUBJxLQ3NPwXrGKDiVjwx/DpPsg=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@tybys/wasm-util/tslib": ["tslib@2.8.1", "", { "bundled": true }, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@emnapi/core/@emnapi/wasi-threads/tslib": ["tslib@2.8.1", "", { "bundled": true }, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@napi-rs/wasm-runtime/@emnapi/core/@emnapi/wasi-threads": ["@emnapi/wasi-threads@1.1.0", "", { "dependencies": { "tslib": "^2.4.0" }, "bundled": true }, "sha512-WI0DdZ8xFSbgMjR1sFsKABJ/C5OnRrjT06JXbZKexJGrDuPTzZdDYfFlsgcCXCyf+suG5QU2e/y1Wo2V/OapLQ=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@napi-rs/wasm-runtime/@emnapi/core/tslib": ["tslib@2.8.1", "", { "bundled": true }, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@napi-rs/wasm-runtime/@emnapi/runtime/tslib": ["tslib@2.8.1", "", { "bundled": true }, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@napi-rs/wasm-runtime/@tybys/wasm-util/tslib": ["tslib@2.8.1", "", { "bundled": true }, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "@tailwindcss/oxide-wasm32-wasi/@napi-rs/wasm-runtime/@emnapi/core/@emnapi/wasi-threads/tslib": ["tslib@2.8.1", "", { "bundled": true }, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
   }
 }