Skip to content

README.md

Latest commit

 

History

History
83 lines (62 loc) · 2.48 KB

README.md

File metadata and controls

83 lines (62 loc) · 2.48 KB
Raw

AE AI Assistant

An Adobe After Effects CEP extension that brings AI-powered automation directly into the After Effects workflow. Generate expressions and ExtendScript code using natural language prompts.

Features

  • Multi-Provider AI Integration: Supports OpenAI, Anthropic Claude, and Google Gemini
  • Dual Generation Modes: Generate both ExtendScript (for automation) and Expressions (for property animation)
  • Agent Mode: Autonomous execution where AI generates and runs code automatically
  • Error Recovery: Automatic error detection and self-correction through AI feedback loops
  • Context Awareness: Incorporates active composition state into code generation
  • Streaming Responses: Real-time code generation display

Project Structure

ae-ai-assistant/
├── CSXS/
│   └── manifest.xml          # CEP extension manifest
├── host/
│   └── index.jsx             # ExtendScript host environment
├── js/
│   └── main.js               # Main application logic
├── lib/
│   └── CSInterface.js        # Adobe CEP interface library
├── styles/
│   └── main.css              # Extension styles
├── index.html                # Extension UI
├── package.json              # Node.js dependencies
├── build.js                  # Build script
├── package-extension.js      # Packaging script
└── .debug                    # Debug configuration

Installation for Development

  1. Install dependencies:

    npm install

  2. Enable CEP debugging:

    • macOS: 
      defaults write com.adobe.CSXS.11 PlayerDebugMode 1
    • Windows: Create registry key HKEY_CURRENT_USER/Software/Adobe/CSXS.11 with PlayerDebugMode = 1

  3. Symlink extension to CEP extensions folder:

    • macOS: ~/Library/Application Support/Adobe/CEP/extensions/
    • Windows: C:\Users\<username>\AppData\Roaming\Adobe\CEP\extensions\

  4. Restart After Effects

Development

  • Run tests: npm test
  • Build extension: npm run build
  • Package extension: npm run package

Testing

The project uses Jest and fast-check for property-based testing:

npm test              # Run all tests
npm run test:watch    # Run tests in watch mode

Requirements

  • Adobe After Effects CC 2020 or later
  • Node.js 14+ (for development)
  • API key from OpenAI, Anthropic, or Google

License

MIT

Contributing

This is an open-source project. Contributions are welcome!