gaia-ui

gaia-ui

Beautifully designed components for building AI Agents 🌎

Stars: 112

Visit
 screenshot

A collection of production-ready UI components designed specifically for building AI assistants and chatbots. These components are battle-tested in production at GAIA, designed to handle edge cases and real-world scenarios, accessible, responsive, and performant. The library focuses on quality over quantity, offering components that solve real problems better than existing alternatives. Users can easily add components to their projects using the provided commands, and the library is actively being developed and refined for better compatibility and smaller bundle sizes.

README:

untitled

GAIA UI - Component Registry

Status Documentation Latest Release

Contributors Open Issues License

Discord Twitter Follow

A collection of production-ready UI components designed specifically for building AI assistants and chatbots. These are the components we use at GAIA, now available for anyone building conversational interfaces.

button

Why This Library?

Building a great chat or assistant interface requires more than just generic UI components. We've spent countless hours refining these components to handle the unique challenges of conversational UIs.

Instead of reinventing the wheel, use the same battle-tested components that power GAIA.

Our Philosophy

Quality Over Quantity - We focus on shipping production-ready components that solve real problems. Each component is:

  • ✅ Battle-tested in production at GAIA
  • ✅ Designed to handle edge cases and real-world scenarios
  • ✅ Accessible, responsive, and performant
  • ✅ Solving problems better than existing alternatives

You won't find generic components that duplicate what's already available. If we're shipping it, it's because we use it in production and it adds genuine value to the ecosystem.

Getting Started

Add components to your project:

npx @heygaia/ui add navbar-menu

Add multiple components at once:

npx @heygaia/ui add raised-button chat-bubble tool-calls-section

Alternative: Using shadcn CLI

You can also use the shadcn CLI directly with the full registry URL:

npx shadcn@latest add https://ui.heygaia.io/r/navbar-menu.json

Or configure the @heygaia namespace in your components.json:

{
  "registries": {
    "@heygaia": "https://ui.heygaia.io/r/{name}.json"
  }
}

Then use namespace syntax:

npx shadcn@latest add @heygaia/navbar-menu

Base Components

This registry uses standard shadcn/ui base components. Install them separately:

npx shadcn@latest add button tooltip avatar dropdown-menu popover skeleton

Documentation

Current Status

GAIA UI is in beta. We're actively migrating components from our internal GAIA codebase, replacing HeroUI with shadcn/ui for better compatibility and smaller bundle sizes. The library is stable and used in production, but APIs may change as we refine components before v1.0.

View detailed roadmap →

Community & Support

Join our growing community of users and contributors:

  • Discord  Discord — Chat with the team and other users.
  • Twitter  Twitter — Get the latest news and updates.
  • GitHub  GitHub — Report issues and contribute.

Contributing

We welcome contributions! Whether you're fixing bugs, improving documentation, or adding new components, we'd love your help.

Read the Contributing Guide →

Quick start for contributors:

  1. Fork the repository
  2. Create your component in registry/new-york/ui/
  3. Add entry to registry.json and run pnpm run registry:build
  4. Test locally with npx shadcn@latest add http://localhost:3000/r/[component-name].json
  5. Submit a pull request

Development

# Install dependencies
pnpm install

# Run dev server
pnpm run dev

# Build registry
pnpm run registry:build

# Type check
pnpm run type

Built With

  • Next.js 15 - For the documentation and registry
  • Tailwind CSS v4 - For styling
  • TypeScript - For type safety
  • Radix UI - For accessible primitives
  • Framer Motion - For animations
  • shadcn CLI - For component installation

Star History

Star History Chart

License

MIT License - feel free to use these components in your projects!


Made with ❤️ by The Experience Company

Discord Twitter GitHub

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for gaia-ui

Similar Open Source Tools

For similar tasks

For similar jobs