The Official CLI for tambo ui.
⚠️ Note: This project is currently in active development. APIs and features may change.
npx tambo full-send
This command will:
While you can install globally, we recommend using npx to ensure you're always using the latest version:
# Using npx (recommended)
npx tambo <command>
initInitialize Tambo in your Next.js project. Two modes available:
# Full setup - recommended for new projects
npx tambo full-send
# Basic setup - just API key configuration
npx tambo init
add <component-name>Add a Tambo component to your project:
# Basic usage
npx tambo add message
# With legacy peer dependencies flag
npx tambo add message --legacy-peer-deps
update <component-name>Update an existing Tambo component in your project:
# Basic usage
npx tambo update message
# With legacy peer dependencies flag
npx tambo update message --legacy-peer-deps
Available components:
message-thread-full - Full-screen chat interface with history and typing indicatorsmessage-thread-panel - Split-view chat with integrated workspacemessage-thread-collapsible - Collapsible chat for sidebarsthread-content - Message thread with grouping and timestampsthread-history - Chat history managementmessage-input - Rich text inputmessage - Individual message display with content formattingmessage-suggestions - AI-powered message suggestionscontrol-bar - Spotlight-style command palettethread-list - Organized chat thread navigationform - Dynamic form with validationinput-fields - Text inputsgraph - Interactive charts (line, bar, scatter, pie)When you add components, they'll be installed in your project following this structure:
your-next-app/
├── src/
│ ├── components/
│ │ └── ui/
│ │ ├── message-thread-full.tsx
│ │ └── ...
│ ├── lib/
│ │ └── tambo.ts # Tool registry
│ └── app/
│ └── layout.tsx # you could add TamboProvider here (for entire app)
└── .env.local # Your API key configuration
The CLI will automatically create/update your .env.local file with:
NEXT_PUBLIC_TAMBO_API_KEY=your-api-key
After initialization, you can add the TamboProvider in one of two ways:
If you just want to add Tambo to specific pages or components, this is the quickest approach:
// In a specific page file (e.g., app/ai-chat/page.tsx)
"use client"; // Important! TamboProvider is a client component
import { TamboProvider } from "@tambo-ai/react";
import { components } from "../../lib/tambo"; // Import components
import { MessageThreadFull } from "@/components/ui/message-thread-full";
export default function AIChat() {
return (
<TamboProvider
apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY ?? ""}
components={components}
>
<MessageThreadFull />
</TamboProvider>
);
}
This approach provides better context sharing between components and is recommended for production apps:
// In your layout file (e.g., app/layout.tsx)
"use client"; // Important! TamboProvider is a client component
import { TamboProvider } from "@tambo-ai/react";
import { components } from "../lib/tambo"; // Import components
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
<TamboProvider
apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY ?? ""}
components={components}
>
{children}
</TamboProvider>
</body>
</html>
);
}
Note: The TamboProvider manages client-side state for features like thread management, message history, and component state. The
"use client"directive is required.
For detailed documentation and examples, visit tambo.co/docs
For more information about all available components and installation options, check out the tambo ui showcase.
This CLI is currently in active development. While core features are stable, you might encounter:
See demos of the components in action:
--> here <--
MIT License - see the LICENSE file for details.
We're building tools for the future of user interfaces. Your contributions matter.
Star this repo to support our work.
Join our Discord to connect with other developers.
Built by developers, for developers.
Because we believe the future is generative.
FAQs
Tambo command-line tool
The npm package tambo receives a total of 252 weekly downloads. As such, tambo popularity was classified as not popular.
We found that tambo demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 4 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Meet Socket at Black Hat & DEF CON 2025 for 1:1s, insider security talks at Allegiant Stadium, and a private dinner with top minds in software supply chain security.
Security News
CAI is a new open source AI framework that automates penetration testing tasks like scanning and exploitation up to 3,600× faster than humans.
Security News
Deno 2.4 brings back bundling, improves dependency updates and telemetry, and makes the runtime more practical for real-world JavaScript projects.