{"id":28852046,"url":"https://github.com/heymaaz/t3.chat.cloneathon","last_synced_at":"2026-05-03T12:34:02.417Z","repository":{"id":299989859,"uuid":"1002380412","full_name":"heymaaz/t3.chat.cloneathon","owner":"heymaaz","description":"Open Source T3 Chat clone. Just add your API keys. Login if you want chat histories","archived":false,"fork":false,"pushed_at":"2025-06-19T09:57:13.000Z","size":1513,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-19T10:20:52.590Z","etag":null,"topics":["ai","convex","openai","openrouter","t3-chat","t3-chat-cloneathon","tanstack-react-router"],"latest_commit_sha":null,"homepage":"https://t3chatcloneathon.netlify.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/heymaaz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-15T10:54:41.000Z","updated_at":"2025-06-19T09:57:17.000Z","dependencies_parsed_at":"2025-06-19T10:21:09.398Z","dependency_job_id":"99faf2a4-3f72-43ad-8026-e7726cd4f20b","html_url":"https://github.com/heymaaz/t3.chat.cloneathon","commit_stats":null,"previous_names":["heymaaz/t3.chat.cloneathon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/heymaaz/t3.chat.cloneathon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heymaaz%2Ft3.chat.cloneathon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heymaaz%2Ft3.chat.cloneathon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heymaaz%2Ft3.chat.cloneathon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heymaaz%2Ft3.chat.cloneathon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heymaaz","download_url":"https://codeload.github.com/heymaaz/t3.chat.cloneathon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heymaaz%2Ft3.chat.cloneathon/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260838479,"owners_count":23070599,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","convex","openai","openrouter","t3-chat","t3-chat-cloneathon","tanstack-react-router"],"created_at":"2025-06-19T22:00:35.498Z","updated_at":"2026-05-03T12:33:57.376Z","avatar_url":"https://github.com/heymaaz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# T3 Chat Clone\n\n\u003cdiv align=\"center\"\u003e\n\n[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/heymaaz/t3.chat.cloneathon)\n\n_A modern AI-powered chatbot with intelligent file search and real-time web search capabilities. Try it out at https://t3chatcloneathon.netlify.app_\n\n[Features](#-features) • [Quick Start](#-quick-start) • [Self Hosting](#️-self-hosting) • [Usage](#-usage) • [Tech Stack](#️-tech-stack)\n\n\u003c/div\u003e\n\n---\n\n## ✨ Features\n\n### 🔍 **Intelligent File Search**\n\n- **Multi-format support**: PDF, TXT, DOCX\n- **AI-powered citations**: Click on file references to preview documents\n- **Contextual understanding**: Conversation-specific vector stores\n- **Smart indexing**: Automatic document processing and search optimization\n\n### 🌐 **Real-time Web Search**\n\n- **Toggle control**: Enable/disable web search per message\n- **Live information**: Access current data and recent events\n- **Source citations**: Clickable links to original sources\n- **Combined search**: Seamlessly merge file and web results\n\n### 💬 **Advanced Chat Experience**\n\n- **Streaming responses**: Real-time AI interaction\n- **Conversation memory**: Persistent chat history\n- **Auto-generated titles**: Smart conversation naming\n- **Modern UI**: Clean, responsive design with dark/light themes\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- [Node.js 18+](https://nodejs.org/) (`nvm install 18 \u0026\u0026 nvm use 18`)\n- [pnpm](https://pnpm.io/) (install globally: `npm install -g pnpm`)\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone \u003crepository-url\u003e\ncd \u003crepo-directory\u003e\n\n# Install dependencies\npnpm install\n\n# Set up environment variables\nnpx convex dev\n```\n\n### Development\n\n```bash\n# Option 1: Cloud Convex (recommended for production)\npnpm dev\n\n# Option 2: Local Convex (for development)\n# Terminal 1:\nnpx convex dev\n# Terminal 2:\npnpm dev:noconvex\n```\n\nOpen [http://localhost:5173](http://localhost:5173) in your browser.\n\n---\n\n## 🏗️ Self Hosting\n\n### Using Local Convex\n\nPerfect for development and testing:\n\n```bash\n# Ensure Node.js 18\nnvm install 18 \u0026\u0026 nvm use 18\n\n# Install dependencies\npnpm install\n\n# Start local Convex backend\nnpx convex dev\n# Follow the prompts:\n# ✓ Start without an account (run Convex locally)\n# ✓ Choose \"new\" project\n# ✓ Name your project (e.g., \"cloneathalon\")\n\n# In a new terminal, start the frontend\nnvm use 18\npnpm dev:noconvex\n```\n\n### Cloud Deployment\n\n#### Deploy to Netlify\n\n[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/heymaaz/t3.chat.cloneathon)\n\n#### Manual Deployment\n\n```bash\n# Build for production\npnpm build\n\n# Deploy the dist/ folder to your hosting provider\n```\n\n---\n\n## 📖 Usage\n\n### 🔍 Web Search\n\n1. Click the **search icon (🔍)** next to the attachment button\n2. When enabled, the button highlights in **blue**\n3. Messages show **\"Web search enabled\"** indicator\n4. AI responses include **clickable web citations**\n\n### 📁 File Upload\n\n1. Click the **plus (+) button** to upload files\n2. **Drag \u0026 drop** or browse for supported formats\n3. Files are **automatically indexed** for intelligent search\n4. AI provides **clickable citations** with document previews\n\n### 💡 Pro Tips\n\n- **Combine searches**: Use both file and web search for comprehensive answers\n- **Citation preview**: Click any file citation to view the referenced content\n- **Conversation context**: Files remain available throughout the chat session\n\n---\n\n## 🛠️ Tech Stack\n\n### Frontend\n\n- **React 19** - Modern UI library with latest features\n- **TypeScript** - Type-safe development\n- **Vite** - Lightning-fast build tool\n- **Tailwind CSS** - Utility-first styling\n- **Tanstack Router** - Type-safe routing\n\n### Backend\n\n- **Convex** - Real-time database and backend platform\n- **Convex Auth** - Secure authentication system\n\n### AI \u0026 Search\n\n- **OpenAI GPT-4.1** - Advanced language model\n- **OpenAI Responses API** - Streaming responses, file search and web search\n- **Vector Stores** - Intelligent document search\n- **Web Search API** - Real-time information retrieval\n- **OpenRouter** - API for Anthropic, xAI, Google and more models\n\n### Development Tools\n\n- **ESLint** - Code linting and quality\n- **Prettier** - Code formatting\n- **Vitest** - Unit testing framework\n- **TypeScript** - Static type checking\n\n---\n\n## 📋 Available Scripts\n\n| Command             | Description                                 |\n| ------------------- | ------------------------------------------- |\n| `pnpm dev`          | Start frontend + cloud Convex backend       |\n| `pnpm dev:noconvex` | Start frontend only (requires local Convex) |\n| `pnpm build`        | Build production bundle                     |\n| `pnpm lint`         | Run ESLint checks                           |\n| `pnpm typecheck`    | Run TypeScript validation                   |\n| `pnpm format`       | Format code with Prettier                   |\n| `pnpm format:check` | Check code formatting                       |\n| `pnpm test`         | Run test suite                              |\n\n---\n\n### Project Structure\n\n```\n\u003crepo-directory\u003e/\n├── src/                 # Frontend React application\n│   ├── components/     # Reusable UI components\n│   ├── pages/         # Application pages\n│   └── lib/           # Utilities and helpers\n├── convex/             # Backend Convex functions\n│   ├── schema.ts      # Database schema\n│   └── *.ts          # API functions and mutations\n└── public/            # Static assets\n```\n\n---\n\n## 🤝 Contributing\n\n1. **Fork** the repository\n2. **Create** your feature branch (`git checkout -b feature/amazing-feature`)\n3. **Commit** your changes (`git commit -m 'Add amazing feature'`)\n4. **Push** to the branch (`git push origin feature/amazing-feature`)\n5. **Open** a Pull Request\n\n### Development Guidelines\n\n- Run `pnpm lint`, `pnpm typecheck`, `pnpm format`, and `pnpm format:check` before committing\n- Follow the existing code style and conventions\n- Add tests for new features when applicable\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with ❤️ using modern web technologies**\n\n[Report Bug](https://github.com/heymaaz/t3.chat.cloneathon/issues) • [Request Feature](https://github.com/heymaaz/t3.chat.cloneathon/issues)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheymaaz%2Ft3.chat.cloneathon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheymaaz%2Ft3.chat.cloneathon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheymaaz%2Ft3.chat.cloneathon/lists"}