Upload README.md with huggingface_hub

README.md

@@ -1,10 +1,193 @@
----
-title: Deepsite Ai Coding
-emoji: 📉
-colorFrom: green
-colorTo: blue
-sdk: docker
-pinned: false
+# DeepSite - AI-Powered Vibe Coding Platform
+
+A modern, AI-powered coding platform built with **Next.js 15** and **AI SDK Elements** that integrates generative AI into your coding projects to enhance creativity and productivity. Support for multiple AI models including DeepSeek-V3, Kimi-K2, Qwen, and more.
+
+![DeepSite Platform](https://img.shields.io/badge/Platform-Next.js%2015-blue)
+![AI SDK](https://img.shields.io/badge/AI%20SDK-Elements-green)
+![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)
+![Tailwind CSS](https://img.shields.io/badge/Tailwind%20CSS-4.0-cyan)
+
+## 🚀 Features
+
+### Core Functionality
+- **AI-Powered Code Editor**: Monaco Editor with intelligent code completion and syntax highlighting
+- **Multi-Model Support**: Switch between different AI models (DeepSeek, Kimi, Qwen, Llama, and more)
+- **Real-time AI Assistance**: Get help with code, debugging, and programming concepts
+- **Conversational Interface**: Natural language interaction with AI for coding tasks
+- **Code Generation**: Generate functions, algorithms, and complete applications
+- **Model Selection**: Choose from 20+ supported AI models across multiple providers
+
+### Supported AI Models
+- **DeepSeek Series**: V3-0324, R1-0528, V3.1, V3.2-Exp
+- **Qwen Series**: Qwen3 Coder 480B, Qwen2.5 VL 7B
+- **Kimi Series**: K2-Instruct, K2-Thinking
+- **Open Source Models**: Llama 3.1/3.3/4 Scout, Gemma 3
+- **Other Models**: GLM-4.6, MiniMax M2
+
+### Technical Stack
+- **Frontend**: Next.js 15, React 19, TypeScript
+- **Styling**: Tailwind CSS 4, shadcn/ui components
+- **Code Editor**: Monaco Editor
+- **AI Integration**: AI SDK Elements with multi-provider support
+- **Providers**: Hugging Face, OpenAI, Anthropic, Google, and more
+
+## 🛠️ Installation
+
+### Prerequisites
+- Node.js 18+ 
+- npm, yarn, or pnpm
+- At least one AI provider API key
+
+### Quick Start
+
+1. **Clone and Install**
+   ```bash
+   git clone <repository-url>
+   cd deepsite-ai-sdk
+   npm install
+   ```
+
+2. **Environment Setup**
+   ```bash
+   cp .env.example .env.local
+   # Edit .env.local with your API keys
+   ```
+
+3. **Get API Keys**
+   - **Hugging Face** (Recommended - Free tier available): 
+     - Visit [Hugging Face](https://huggingface.co/settings/tokens)
+     - Generate a new access token
+   - **OpenAI**: [OpenAI API Keys](https://platform.openai.com/api-keys)
+   - **Anthropic**: [Anthropic Console](https://console.anthropic.com/)
+
+4. **Run Development Server**
+   ```bash
+   npm run dev
+   ```
+
+5. **Open in Browser**
+   ```
+   http://localhost:3000
+   ```
+
+## 🎯 Usage
+
+### Code Editor
+1. **Write Code**: Use the Monaco editor with full-featured JavaScript support
+2. **Get AI Help**: Ask questions about your code in natural language
+3. **Code Generation**: Request AI to generate functions, algorithms, or complete features
+4. **Debugging**: Ask AI to help identify and fix issues in your code
+
+### AI Assistant Chat
+- **General Questions**: Ask about programming concepts, best practices
+- **Code Review**: Request code analysis and improvement suggestions
+- **Learning**: Get explanations of code patterns and algorithms
+- **Problem Solving**: Discuss coding challenges and get guidance
+
+### Model Selection
+- Choose from 20+ AI models in the header dropdown
+- Models are organized by provider (Hugging Face, OpenAI, etc.)
+- Each model has a specific category (Reasoning, Code, Vision, General)
+- Switch models based on your specific task requirements
+
+## 🔧 Configuration
+
+### API Key Setup
+The application supports multiple AI providers. Configure at least one:
+
+```env
+# Primary (Hugging Face - Free tier available)
+HUGGINGFACE_API_KEY=your_key_here
+
+# Optional (for additional models)
+OPENAI_API_KEY=your_openai_key
+ANTHROPIC_API_KEY=your_claude_key
+GOOGLE_API_KEY=your_gemini_key
+```
+
+### Model Customization
+Models are configured in `components/providers.tsx`. You can:
+- Add new models
+- Modify model categories
+- Configure provider settings
+
+### UI Customization
+- Edit `tailwind.config.ts` for styling changes
+- Modify components in `components/ui/` for UI elements
+- Update themes in `app/globals.css`
+
+## 🏗️ Project Structure
+
+```
+deepsite-ai-sdk/
+├── app/                    # Next.js 15 app router
+│   ├── api/completion/     # AI completion API endpoint
+│   ├── globals.css        # Global styles
+│   ├── layout.tsx         # Root layout
+│   └── page.tsx           # Main page
+├── components/            # React components
+│   ├── ui/               # shadcn/ui base components
+│   ├── code-editor.tsx   # Monaco editor component
+│   ├── model-selector.tsx # AI model selector
+│   ├── conversation-panel.tsx # Chat interface
+│   └── providers.tsx     # AI SDK providers
+├── lib/                  # Utilities
+│   └── utils.ts         # Helper functions
+├── package.json         # Dependencies
+├── tailwind.config.ts   # Tailwind configuration
+└── tsconfig.json       # TypeScript configuration
+```
+
+## 🤖 AI SDK Elements Integration
+
+This project leverages **AI SDK Elements** to provide:
+
+- **Provider Abstraction**: Unified interface for multiple AI providers
+- **Streaming Support**: Real-time AI responses
+- **Type Safety**: Full TypeScript support for AI operations
+- **Component Library**: Pre-built AI-native UI components
+- **Model Management**: Easy switching between AI models
+
+## 📚 Available Scripts
+
+- `npm run dev` - Start development server
+- `npm run build` - Build for production
+- `npm run start` - Start production server
+- `npm run lint` - Run ESLint
+
+## 🔐 Security & Privacy
+
+- **API Keys**: Never commit your API keys to version control
+- **Local Processing**: All code editing happens locally in your browser
+- **API Calls**: AI requests are sent directly to provider APIs
+- **Environment Variables**: Sensitive data stored in environment variables only
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- **AI SDK Elements** - Component library for AI-native applications
+- **shadcn/ui** - Beautiful and accessible UI components
+- **Monaco Editor** - VS Code's editor in the browser
+- **Hugging Face** - AI model hosting and APIs
+- **Next.js Team** - Amazing React framework
+
+## 🆘 Support
+
+- **Documentation**: Check the `/docs` folder for detailed guides
+- **Issues**: Report bugs and request features via GitHub Issues
+- **Community**: Join our discussions in GitHub Discussions
+
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+**Built with ❤️ by MiniMax Agent using AI SDK Elements and Next.js 15**