Seed is a TypeScript-based tool for automatically generating realistic dummy data for databases, targeting developers and testers who need to populate their databases for local development and testing. It simplifies data creation by automatically handling value generation, relationships, and offering type-safe code, deterministic outputs, and AI-assisted data examples.

How It Works

Seed leverages a TypeScript client generated from your database schema, enabling type-safe data definition. It uses Copycat for deterministic data generation, ensuring consistent results across runs. For text-based fields, it integrates with LLMs (OpenAI, Groq) to generate example data based on column descriptions, which are then saved and can be refined by the user.

Quick Start & Requirements

• Install via npx @snaplet/seed init.
• Requires Node.js and a database connection.
• AI features require OPENAI_API_KEY or GROQ_API_KEY environment variables.
• Documentation: https://docs.snaplet.dev/

Highlighted Details

• Type-safe data generation with a generated TypeScript client.
• Deterministic data generation using Copycat.
• AI-assisted data example generation for text fields.
• Automatic handling of relational data.

Maintenance & Community

The project is part of the Supabase community. Development setup involves Nix for managing dependencies.

Licensing & Compatibility

MIT License. Permissive for commercial use and integration with closed-source projects.

Limitations & Caveats

The project is actively developed, and while the core functionality is robust, advanced features like AI data generation may require specific API keys and configuration. The Nix-based development environment setup is detailed but may present a learning curve for users unfamiliar with Nix.