🧠 TC AI - Your Cognitive AI Assistant

Developed by TehranCommunity (TC)

Lead Developer: D3F417

The most beautiful and intelligent AI chat interface you've ever seen ✨

---

🚀 Live Demo

✨ Experience TC AI Right Now!

🌐 Try TC AI Live →

No installation required! Jump straight into the future of AI conversations with our live demo. Experience all features including multi-model support, real-time responses, and our stunning interface.

---

🌟 What is TC AI?

TC AI is not just another chatbot interface - it's a revolutionary cognitive AI assistant that combines cutting-edge technology with stunning visual design. Built by the passionate developers at TehranCommunity, this project represents the future of human-AI interaction.

🎯 Why TC AI?

• 🚀 Lightning Fast: Optimized performance with instant responses
• 🎨 Visually Stunning: Unique dark pink gradient design that's easy on the eyes
• 🧠 Smart & Intuitive: Advanced chat management with intelligent features
• 📱 Universal: Perfect experience across all devices and screen sizes
• 🔒 Privacy First: All conversations stored locally on your device
• ⚡ Multiple AI Models: Switch between different AI models seamlessly

✨ Incredible Features

🎪 Visual Excellence

• Mesmerizing UI/UX: Custom dark pink gradient design with buttery smooth animations
• Responsive Magic: Flawless experience from mobile to 4K displays
• Theme Flexibility: Built-in dark/light theme support
• Framer Motion: Silky smooth animations that feel alive

🚀 Performance & Speed

• Instant Loading: Optimized Next.js 14 with App Router for blazing fast performance
• Real-time Everything: Live typing indicators and instant message rendering
• Smart Caching: Intelligent data management for optimal speed
• Zero Lag: Smooth interactions even with large conversation histories

🧠 Intelligent Features

• Advanced Chat Management: Create, rename, delete, and organize conversations effortlessly
• Multi-Model Support: Switch between 15+ powerful AI models on the fly
• Smart Memory: Persistent chat history with intelligent organization
• Audio Integration: Built-in audio player for voice messages and responses
• Context Awareness: Maintains conversation context across sessions

🤖 Supported AI Models

TC AI supports 15+ cutting-edge AI models from leading companies, all completely free:

🚀 OpenAI Models

• GPT-4.1 Nano - Lightning-fast general purpose AI
• GPT-4.1 Nano Fast - Ultra-speed variant for quick responses
• GPT-5 Nano - Next-generation AI with advanced capabilities
• GPT-4o Audio - Multimodal AI with voice input/output support
• GPT-4.1 Large - Premium large-scale model
• o4-mini Reasoning - Advanced reasoning and problem-solving

🧠 Meta Llama Models

• Llama 3.1 8B - Efficient and powerful open-source AI
• Llama 3.2 11B Vision - Advanced vision-capable model

🌟 Specialized Models

• Google Gemini 2.5 Flash Lite - Google's fast and efficient AI
• Mistral Small 3.1 - European AI excellence
• Qwen 2.5 Coder - Specialized coding assistant by Alibaba
• BIDARA - NASA's biomimetic research assistant
• DeepSeek R1 - Advanced reasoning model

🎵 Creative & Specialized

• MIDIjourney - AI music generation
• Mirexa AI - Creative companion
• Rtist - Artistic AI assistant

🔓 Uncensored Models

• Evil - Uncensored AI for unrestricted conversations
• Unity - Unrestricted agent for open discussions

All models feature:

• ✅ 100% Free - No hidden costs or limits
• ⚡ Real-time switching - Change models instantly
• 🔧 Tool support - Advanced function calling
• 🖼️ Vision capabilities - Image understanding (select models)
• 🎵 Audio support - Voice input/output (select models)

🛡️ Security & Privacy

• Local Storage: All your conversations stay on your device
• Secure API Integration: Safe and encrypted communication with AI services
• No Data Mining: Your privacy is our top priority
• TypeScript Safety: Full type safety prevents runtime errors

🚀 Tech Stack

• Framework: Next.js 14 with App Router
• Language: TypeScript
• Styling: Tailwind CSS
• UI Components: Custom components with Radix UI primitives
• Animations: Framer Motion
• Icons: Lucide React
• State Management: React Context API
• Storage: Local Storage for chat persistence

🚀 Quick Start Guide

📋 Prerequisites

• Node.js 18+ installed on your system
• Your favorite package manager (npm, yarn, or pnpm)
• A modern web browser

⚡ Installation

1. Clone the TC AI repository:

git clone https://github.com/mostaghell/TCommunity-AI-Web-Application.git
cd tc-ai

2. Install dependencies:

# Using npm
npm install

# Using yarn
yarn install

# Using pnpm (recommended for speed)
pnpm install

3. Configure your environment:

cp .env.example .env.local

🔑 API Configuration

Important: TC AI requires API keys to function properly. Add your API keys to .env.local:

# Required: Pollinations AI API Token
POLLINATIONS_API_TOKEN=your_pollinations_api_token_here

# Optional: Add other AI service tokens
# OPENAI_API_KEY=your_openai_key_here
# ANTHROPIC_API_KEY=your_anthropic_key_here

🔗 How to get API keys:

• Pollinations AI: Visit pollinations.ai to get your free API token
• OpenAI: Get your key from platform.openai.com
• Anthropic: Visit console.anthropic.com

🎉 Launch TC AI

# Start the development server
npm run dev
# or
yarn dev
# or
pnpm dev

🌐 Open http://localhost:3000 and experience the magic!

🎯 Production Build

# Build for production
npm run build
npm start

# or with other package managers
yarn build && yarn start
pnpm build && pnpm start

🏗️ Project Structure

├── app/                    # Next.js App Router
│   ├── api/               # API routes
│   ├── globals.css        # Global styles
│   ├── layout.tsx         # Root layout
│   └── page.tsx           # Home page
├── components/            # React components
│   ├── ui/               # Reusable UI components
│   ├── chat-header.tsx   # Chat header component
│   ├── chat-input.tsx    # Message input component
│   ├── chat-message.tsx  # Message display component
│   ├── chat-sidebar.tsx  # Chat list sidebar
│   └── ...
├── contexts/             # React contexts
│   └── chat-context.tsx # Chat state management
├── hooks/               # Custom React hooks
├── lib/                 # Utility functions
├── public/              # Static assets
├── styles/              # Additional styles
└── utils/               # Helper utilities

🎨 Key Components

Chat Management

• ChatContext: Centralized state management for all chat operations
• ChatSidebar: Interactive sidebar for chat navigation and management
• ChatHeader: Clean header with title and subtitle

Message System

• ChatMessage: Renders individual messages with proper formatting
• ChatInput: Advanced input component with send functionality
• TypingIndicator: Smooth typing animations

UI Components

• BackgroundEffect: Animated gradient background
• ModelSelector: AI model selection interface
• AudioPlayer: Built-in audio playback support

🔧 Configuration

The project uses several configuration files:

• tailwind.config.ts: Tailwind CSS configuration
• next.config.mjs: Next.js configuration
• tsconfig.json: TypeScript configuration
• components.json: UI components configuration

🎯 Usage

1. Start a New Chat: Click the "New Chat" button in the sidebar
2. Send Messages: Type your message and press Enter or click Send
3. Manage Chats: Right-click on chat items to rename or delete
4. Switch Models: Use the model selector to choose different AI models
5. Responsive Design: The interface adapts to different screen sizes

🤝 Join the TC Community

TehranCommunity (TC) welcomes developers from around the world! We believe in the power of collaboration and open-source development.

🌟 How to Contribute

1. 🍴 Fork the repository
2. 🌿 Create your feature branch (git checkout -b feature/AmazingFeature)
3. 💻 Code with passion and follow our coding standards
4. ✅ Test your changes thoroughly
5. 📝 Commit your changes (git commit -m 'Add some AmazingFeature')
6. 🚀 Push to the branch (git push origin feature/AmazingFeature)
7. 🎉 Open a Pull Request

🎯 Contribution Guidelines

• Follow TypeScript best practices
• Maintain the existing code style
• Add tests for new features
• Update documentation when needed
• Be respectful and collaborative

👥 Meet the Team

🏢 TehranCommunity (TC)

Building the future of AI interfaces

🚀 Lead Developer & Architect
D3F417
The mastermind behind TC AI's revolutionary design

---

🌐 Connect with TehranCommunity

---

"We're not just building software, we're crafting experiences that bridge the gap between humans and artificial intelligence."

📄 License

This project is proudly open source and available under the MIT License.

🙏 Special Thanks

Powered by incredible technologies:

---

🧠 TC AI

Your Cognitive AI Assistant for Intelligent Conversations

Made with ❤️ by [TehranCommunity](https://github.com/mostaghell

Experience the future of AI interaction today!