turnip documentation

AI-powered agent for generating and tokenizing unique art on Solana

Introduction

turnip is an intelligent agent that combines cutting-edge AI image generation (OpenAI GPT Image 1.5) with Solana blockchain tokenization via pump.fun API and Helius APIs. Generate unique, one-of-a-kind artwork and instantly deploy it as a token on-chain with just a few commands.

Key Features

AI Art Generation

Uses OpenAI GPT Image 1.5 - the most advanced image generation model - to create stunning, unique artwork from text prompts with high fidelity and detail.

On-Chain Tokenization

Seamlessly deploy your generated art as tokens on Solana using pump.fun API. IPFS metadata hosting included.

Helius RPC Integration

High-performance Solana RPC via Helius for fast, reliable blockchain transactions and real-time token tracking.

One-Command Deployment

Generate art and deploy tokens with a single CLI command. No complex setup or manual steps required.

Architecture Overview

turnip is built with a modular architecture that separates concerns and makes the codebase easy to understand and extend:

turnip/
├── src/
│   ├── cli.ts              # Entry point & environment validation
│   ├── agent.ts            # Main TurnipAgent class
│   ├── dashboard.ts        # Token tracking dashboard
│   ├── ai/
│   │   └── generator.ts    # OpenAI GPT Image 1.5 integration
│   └── solana/
│       ├── pumpfun.ts      # pump.fun token deployment
│       └── helius.ts       # Helius RPC client
└── .env                    # Configuration

Important Disclaimers

Blockchain Risk: Deploying tokens on Solana involves real costs (SOL for gas). Only deploy with funds you can afford to lose. turnip is a tool, not financial advice. Always perform your own research (DYOR).

Beta Software: turnip is actively developed and may contain bugs. AI-generated images may not always match expectations. Review all outputs before deploying on-chain.

Next Steps

Ready to get started? Follow our comprehensive guides: