feedeas 0.1.0-alpha.1 → 0.1.0-alpha.10

package/.env.example

@@ -0,0 +1,22 @@
+# 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
+
+# Optional: PostHog project key for CLI telemetry
+# If set, Feedeas emits basic command events (started/finished).
+POSTHOG_KEY=your-posthog-project-key-here
+
+# Optional: Disable telemetry even when POSTHOG_KEY is set
+# FEDEAS_TELEMETRY_DISABLED=true
+
+# 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,162 @@
-# 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
 ```
 
-To run:
+### Basic Usage
 
 ```bash
-bun run index.ts
+# 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
 ```
 
-This project was created using `bun init` in bun v1.2.2. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.
+## 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"
+
+# Reel-ready portrait generation (recommended for 9:16 videos)
+feedeas imagine "Electric SUV charging at dusk" --aspect-ratio 9:16 --image-size 2K -o ev_portrait.png
+
+# 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!
+
+`imagine` defaults to `--aspect-ratio auto`:
+- If `scene_1.json` exists, it infers from `meta.width:meta.height`
+- Otherwise it falls back to `9:16`
+
+**[📖 Full Imagine Command Documentation](./docs/IMAGINE_COMMAND.md)**
+
+### AI BGM Generation (Contract Draft)
+
+Gemini-first command contract and backend request types for `feedeas bgm` are documented here:
+
+**[📖 BGM Command Contract](./docs/BGM_COMMAND.md)**
+
+Basic usage:
+
+```bash
+# Generate 20s background music into assets/bgm.mp3
+feedeas bgm "ambient cinematic underscore, no vocals" -d 20 -o bgm.mp3
+```
+
+### 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 }
+    }
+  ]
+}
+```
+
+For `image` entities, add `"fit": "smart"` to reduce accidental cropping on mismatched aspect ratios.
+
+## 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
+# Run in development mode
+bun run dev
+
+# Build CLI and UI
+bun run build
+
+# Run CLI directly
+bun run feedeas
+```
+
+## 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/bin/feedeas.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '../dist/cli/index.js';