Skip to content

A magical AI-powered avatar generator that transforms text descriptions into stunning, personalized digital avatars. Built with Next.js and integrated with advanced AI models.

Notifications You must be signed in to change notification settings

ahkamboh/avatar-generator

Repository files navigation

AI Avatar Generator

A magical AI-powered avatar generator that transforms text descriptions into stunning, personalized digital avatars. Built with Next.js and integrated with advanced AI models.

Prompt: Create a 3D avatar of a smiling man with brown skin, black beard, red turban, red kurta, brown shawl, warm brown eyes, on a soft red gradient background

OUTPUT

WhatsApp Image 2024-12-01 at 12 23 58_6abb2306

✨ Features

  • Text-to-avatar generation
  • Magical UI/UX design
  • Daily generation limits (4 per day)
  • One-click avatar downloads
  • Real-time generation status
  • Error handling and retry mechanisms

🚀 Tech Stack

  • Frontend: Next.js 14, React, TypeScript
  • Styling: Tailwind CSS, Shadcn UI
  • AI Integration: Gradio Client
  • Deployment: Vercel

🛠️ Prerequisites

Before you begin, ensure you have:

  • Node.js (version 18 or higher)
  • npm or yarn package manager

📦 Installation

  1. Clone the repository:
git clone https://github.com/ahkamboh/avatar-generator.git
cd avatar-generator
  1. Install dependencies:
npm install
# or
yarn install
  1. Create a .env.local file:
NEXT_PUBLIC_APP_URL=http://localhost:3000

🏃‍♂️ Running the Application

Start the development server:

npm run dev
# or
yarn dev

Open http://localhost:3000 to view the application.

🌟 Usage

  1. Enter your text description
  2. Click "Generate Avatar"
  3. Wait for the magical generation process
  4. Download your avatar with one click

⚡ Usage Limits

  • 4 avatar generations per day per user
  • Resets at midnight local time
  • Maximum processing time: 30 seconds per generation

🎨 Features in Detail

  • Text-to-Avatar: Transform text descriptions into unique avatars
  • Daily Limits: Fair usage system with 4 generations per day
  • Download Options: Easy download of generated avatars
  • Responsive Design: Works on all devices
  • Real-time Status: Live generation progress updates

👥 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

👨‍💻 Author

📄 License

MIT License

🙏 Acknowledgments

  • Next.js framework by Vercel
  • Shadcn UI for components
  • Apple Memoji model integration

Made with ❤️ by Ali Hamza Kamboh

About

A magical AI-powered avatar generator that transforms text descriptions into stunning, personalized digital avatars. Built with Next.js and integrated with advanced AI models.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published