T2Chat

The modern, open-source AI chat application.
Explore Features »

Getting Started · Deployment · Contributing · Issues

About T2Chat

AI chat infrastructure for absolutely everyone

The open source ChatGPT alternative. You are in charge of your own data, conversations, and AI models.

ChatGPT and other AI chat tools are incredible. They've revolutionized how we interact with AI. We use them for work, learning, creative projects, and problem-solving. However, most tools are very limited in terms of control, customization, and data ownership.

That's where T2Chat comes in. Self-hosted or hosted by us. Multi-model by design. API-driven and ready to be deployed on your own domain. Full control of your conversations and data.

✨ Features

• 🤖 Multi-Model AI Support: Integration with multiple AI providers (OpenAI, Google, Groq, OpenRouter, etc.)
• 💬 Real-time Chat: Instant messaging with AI models using streaming responses
• 📱 Responsive Design: Beautiful UI that works seamlessly on desktop and mobile
• 🔐 Secure Authentication: User authentication with Better Auth and PostgreSQL
• 💾 Data Persistence: Chat history stored securely in Convex database
• 🎨 Customizable Interface: Dark/light themes with extensive customization options
• 🗂️ Advanced Chat Management: Organize, rename, share, and delete conversations
• 🔑 API Key Management: Secure storage and management of your API keys
• 🎤 Speech Features: Text-to-speech and speech recognition capabilities
• 📤 File Uploads: Support for file attachments via UploadThing
• 🔍 Smart Search: Search through your entire conversation history
• ⚙️ Comprehensive Settings: Extensive customization and personalization options
• 🌐 Easy Sharing: Share conversations with others securely
• 📊 Chat Analytics: Track your usage and conversation metrics
• 🔄 Chat Branching: Create conversation branches for different discussion paths
• ⚡ Optimized Performance: Fast loading and smooth interactions

🛠️ Built With

Frontend

• Next.js 15 - React framework with App Router
• React 19 - Latest React with concurrent features
• TypeScript - Type-safe JavaScript
• Tailwind CSS - Utility-first CSS framework
• Framer Motion - Smooth animations and transitions
• Radix UI - Accessible UI components
• Lucide React - Beautiful icon library

Backend & Database

• Convex - Real-time backend-as-a-service
• Better Auth - Modern authentication solution
• PostgreSQL - Database for authentication data

AI & APIs

• AI SDK - Unified AI provider interface
• OpenRouter - AI model routing and access
• Google AI - Gemini models
• Groq - Fast AI inference
• UploadThing - File upload service

Development Tools

• ESLint - Code linting
• Prettier - Code formatting
• Dexie - IndexedDB wrapper for local storage

Getting Started

To get a local copy up and running, please follow these simple steps.

Prerequisites

Here is what you need to be able to run T2Chat.

• Node.js (Version: >=18.x)
• PostgreSQL (Version: >=13.x)
• npm/yarn/pnpm (npm recommended)

If you want to enable any of the available AI integrations, you may want to obtain API keys for each provider. More details can be found below under the AI Providers section.

Development

Setup

1. Clone the repository

   git clone https://github.com/nyaughh/t2chat.git
   cd t2chat

2. Install dependencies

   npm install
   # or
   yarn install
   # or
   pnpm install

3. Set up environment variables

   Create a .env.local file in the root directory:

   # Convex
   CONVEX_DEPLOYMENT=your-convex-deployment-url
   NEXT_PUBLIC_CONVEX_URL=your-convex-url
   
   # Better Auth
   BETTER_AUTH_SECRET=your-auth-secret
   BETTER_AUTH_URL=http://localhost:3000
   
   # UploadThing
   UPLOADTHING_SECRET=your-uploadthing-secret
   UPLOADTHING_APP_ID=your-uploadthing-app-id
   
   # AI Providers (optional - can be configured in UI)
   OPENAI_API_KEY=your-openai-key
   GOOGLE_AI_API_KEY=your-google-ai-key
   GROQ_API_KEY=your-groq-key

4. Set up Convex

   npx convex dev

   This will:

   • Create a new Convex project (if needed)
   • Set up the database schema
   • Deploy your functions

5. Set up the database

   npx better-auth migrate

6. Start the development server

   npm run dev
   # or
   yarn dev
   # or
   pnpm dev

7. Open your browser

   Navigate to http://localhost:3000

Quick start with npm run dev

npm run dev

This will start the development server and you can begin using T2Chat immediately.

Deployment

Vercel

1. Install Vercel CLI

   npm i -g vercel

2. Deploy

   vercel

3. Configure environment variables

   Add all your environment variables in the Vercel dashboard.

Railway

Docker

The Docker configuration for T2Chat provides a containerized deployment option.

1. Build the Docker image

   docker build -t t2chat .

2. Run the container

   docker run -p 3000:3000 t2chat

Other Platforms

T2Chat can be deployed to any platform that supports Next.js:

• Netlify
• DigitalOcean App Platform
• AWS Amplify
• Google Cloud Run

Make sure to:

1. Set all required environment variables
2. Build the application with npm run build
3. Configure the start command as npm run start

⚙️ Configuration

AI Providers

Configure AI providers in the Settings → Models & Keys section:

OpenAI

1. Get your API key from OpenAI
2. Add it in settings or set OPENAI_API_KEY environment variable

Google AI

1. Get your API key from Google AI Studio
2. Add it in settings or set GOOGLE_AI_API_KEY environment variable

Groq

1. Get your API key from Groq Console
2. Add it in settings or set GROQ_API_KEY environment variable

OpenRouter

1. Get your API key from OpenRouter
2. Access to 100+ models through a single API

Customization

T2Chat supports extensive customization:

• Themes: Light/dark mode with custom color schemes
• Fonts: Choose from multiple font options for main text and code
• User Profile: Set your name, role, and personality traits
• Behavior: Configure send behavior (Enter vs Ctrl+Enter) and auto-save
• Speech: Text-to-speech settings and voice selection

📁 Project Structure

t2chat/
├── src/
│   ├── app/                    # Next.js App Router pages
│   │   ├── (chat)/            # Chat-related pages and components
│   │   ├── api/               # API routes (auth, chat, uploadthing)
│   │   ├── auth/              # Authentication pages
│   │   └── settings/          # Settings page
│   ├── components/            # React components
│   │   ├── ui/                # UI components (buttons, inputs, etc.)
│   │   └── settings/          # Settings-specific components
│   ├── hooks/                 # Custom React hooks
│   ├── lib/                   # Utility libraries and configurations
│   └── styles/               # Global styles and CSS
├── convex/                    # Convex backend functions
│   ├── chat/                 # Chat-related backend functions
│   ├── auth.ts               # Authentication configuration
│   └── schema.ts             # Database schema definitions
├── public/                    # Static assets and images
├── package.json              # Dependencies and npm scripts
├── tailwind.config.ts        # Tailwind CSS configuration
├── next.config.ts            # Next.js configuration
└── README.md                 # This file

Repo Activity

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Getting Started

1. Fork the repository
2. Create a feature branch

   git checkout -b feature/amazing-feature

3. Make your changes
4. Commit your changes

   git commit -m 'Add some amazing feature'

5. Push to the branch

   git push origin feature/amazing-feature

6. Open a Pull Request

Development Guidelines

• Code Style: Use Prettier for formatting (npm run format)
• Linting: Ensure ESLint passes (npm run lint)
• TypeScript: Maintain type safety throughout the codebase
• Testing: Add tests for new features when applicable
• Documentation: Update documentation for significant changes

Good First Issues

We have a list of help wanted issues that are great for newcomers. These contain features and bugs with limited scope, perfect for getting started.

License

Distributed under the MIT License. See LICENSE for more information.

This means you can:

• ✅ Use commercially
• ✅ Modify and distribute
• ✅ Use privately
• ✅ Include in proprietary software

🙏 Acknowledgments

Special thanks to these amazing projects which help power T2Chat:

• Vercel - Deployment and AI SDK
• Convex - Real-time backend infrastructure
• Better Auth - Authentication solution
• Radix UI - Accessible UI primitives
• Tailwind CSS - Utility-first CSS framework
• OpenAI - AI models and API
• OpenRouter - AI model routing

📞 Support

If you need help with T2Chat:

1. Check the documentation in this README
2. Search existing issues on GitHub
3. Create a new issue if you found a bug
4. Start a discussion for feature requests or questions

---

Built by kmrb.tech

⭐ Star us on GitHub if `T2Chat` helps you!