POVgoblin 🧙‍♂️🖥️

An AI-powered POV-Ray scene generation assistant that leverages computational creativity to craft unique 3D scenes.

Installation 🚀

npm install -g povgoblin

Requires POV-Ray (https://www.povray.org/download/)

Overview 🌟

POVgoblin generates and renders 3D scenes using POV-Ray, combining AI-driven creativity with precise computational rendering. It provides flexible interfaces for scene generation and exploration.

Usage 🛠️

Command-line Usage

$ povgoblin "A depiction of the solar system"

The CLI returns the relative path to the generated scene image, making it easy to:

• Open the image
• Use in other workflows
• Track and manage generated scenes

Programmatic Usage

import povgoblin from 'povgoblin';

async function generate() {
  try {
    const result = await povgoblin(prompt, {
      home: 'data/scenes', // Directory for generated scenes
      maximum: 30,         // Maximum generation attempts
      delay: 0.5           // Delay (in seconds) between attempts
    });
    console.log(`Scene rendered: ${result}`);
  } catch (error) {
    console.error('Scene generation failed', error);
  }
}

Configuration 🔧

POVgoblin relies upon Phantomaton configuration.

An AI Studio API key is required for AI-powered scene generation.

Example configuration:

{
  "phantomaton-gemini": {
    "apiKey": "your-ai-studio-api-key"
  }
}

Features 💫

• 🧙‍♂️ AI-powered scene generation
• 🖥️ Automated POV-Ray rendering
• 📚 Built-in documentation lookup
• 🎨 Computational creativity
• 🌈 Unique, algorithmically generated scenes

Requirements 🛠️

• POV-Ray 3.7+
• Anthropic API key
• Node.js 16+

Contributing 🦄

Contributions welcome! Submit ideas, bug reports, and pull requests to our GitHub repository.

License 🔒

MIT License