README.md 및 Vercel 배포 가이드 업데이트: 빠른 시작 섹션 추가 및 배포 단계 간소화

Author: cgoinglove

README.md

@@ -13,6 +13,16 @@
 - **MCP Tools Demo:** [Chat with Tools](https://better-chatbot-demo.vercel.app/export/a4820921-8012-496b-8a5d-13757050bafe)
 - **Image Generation Demo:** [Chat with Image Generation](https://better-chatbot-demo.vercel.app/export/452ad745-9efb-49ae-9114-10db15f1b827)
 
+## Quick Start 🚀
+
+> **Get your app running in minutes! No installation or payment required.**
+
+You only need **one AI Provider API Key** (OpenAI, Claude, Gemini, etc.). Everything else runs on free tiers - database, file storage, and hosting.
+
+👉 **[Click this guide to deploy your site with just a few clicks](docs/tips-guides/vercel.md)**
+
+---
+
 **Better Chatbot** - A better open-source AI chatbot for individuals and teams, inspired by ChatGPT, Claude, Grok, and Gemini.
 
 • **Multi-AI Support** - Integrates all major LLMs: OpenAI, Anthropic, Google, xAI, Ollama, and more  
@@ -26,45 +36,6 @@
 
 Built with Vercel AI SDK and Next.js, combining the best features of leading AI services into one platform.
 
-### Quick Start 🚀
-
-```bash
-# 1. Clone the repository
-
-git clone https://github.com/cgoinglove/better-chatbot.git
-cd better-chatbot
-
-# 2. (Optional) Install pnpm if you don't have it
-
-npm install -g pnpm
-
-# 3. Install dependencies
-
-pnpm i
-
-# 4. (Optional) Start a local PostgreSQL instance
-
-pnpm docker:pg
-
-# If you already have your own PostgreSQL running, you can skip this step.
-# In that case, make sure to update the PostgreSQL URL in your .env file.
-
-# 5. Enter required information in the .env file
-
-# The .env file is created automatically. Just fill in the required values.
-# For the fastest setup, provide at least one LLM provider's API key (e.g., OPENAI_API_KEY, CLAUDE_API_KEY, GEMINI_API_KEY, etc.) and the PostgreSQL URL you want to use.
-
-# 6. Start the server
-
-pnpm build:local && pnpm start
-
-# (Recommended for most cases. Ensures correct cookie settings.)
-# For development mode with hot-reloading and debugging, you can use:
-# pnpm dev
-```
-
-Open [http://localhost:3000](http://localhost:3000) in your browser to get started.
-
 ## Table of Contents
 
 - [Table of Contents](#table-of-contents)

docs/tips-guides/vercel.md

@@ -1,35 +1,53 @@
 # Vercel Deployment Guide
 
+The easiest way to get started with **better-chatbot** is to deploy it directly to Vercel.
+You only need **one AI Provider API Key** (OpenAI, Gemini, Claude, etc.) to run the app.
+Database, file storage, and caching are all available on free tiers.
+
+---
+
+## Steps
+
 1. **Click this button** to start the deployment process:
-   [![Deploy with Vercel](https://vercel.com/button)](<https://vercel.com/new/clone?repository-url=https://github.com/cgoinglove/better-chatbot&env=BETTER_AUTH_SECRET&env=OPENAI_API_KEY&env=GOOGLE_GENERATIVE_AI_API_KEY&env=ANTHROPIC_API_KEY&envDescription=BETTER_AUTH_SECRET+is+required+(enter+any+secret+value).+At+least+one+LLM+provider+API+key+(OpenAI,+Claude,+or+Google)+is+required,+but+you+can+add+all+of+them.+See+the+link+below+for+details.&envLink=https://github.com/cgoinglove/better-chatbot/blob/main/.env.example&demo-title=better-chatbot&demo-description=An+Open-Source+Chatbot+Template+Built+With+Next.js+and+the+AI+SDK+by+Vercel.&products=[{"type":"integration","protocol":"storage","productSlug":"neon","integrationSlug":"neon"},{"type":"integration","protocol":"storage","productSlug":"upstash-kv","integrationSlug":"upstash"},{"type":"blob"}]>)
+   [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/cgoinglove/better-chatbot&env=BETTER_AUTH_SECRET&env=OPENAI_API_KEY&env=GOOGLE_GENERATIVE_AI_API_KEY&env=ANTHROPIC_API_KEY&envDescription=BETTER_AUTH_SECRET+is+required+%28enter+any+secret+value%29.+At+least+one+LLM+provider+API+key+%28OpenAI,+Claude,+or+Google%29+is+required,+but+you+can+add+all+of+them.+See+the+link+below+for+details.&envLink=https://github.com/cgoinglove/better-chatbot/blob/main/.env.example&demo-title=better-chatbot&demo-description=An+Open-Source+Chatbot+Template+Built+With+Next.js+and+the+AI+SDK+by+Vercel.&products=[{%22type%22:%22integration%22,%22protocol%22:%22storage%22,%22productSlug%22:%22neon%22,%22integrationSlug%22:%22neon%22},{%22type%22:%22integration%22,%22protocol%22:%22storage%22,%22productSlug%22:%22upstash-kv%22,%22integrationSlug%22:%22upstash%22},{%22type%22:%22blob%22}])
 
 2. **Click the "Create" button** on Vercel to begin setting up your project.
 
    <img width="1254" alt="step2" src="https://github.com/user-attachments/assets/66806fa8-2d55-4e57-ad7e-2f37ef037a97" />
 
-3. **Add Neon Postgres and create a database.**
-   Click the "Neon Postgres Add" button to create a database. This is available even on the free plan.
+3. **Add all required resources.**
+   When prompted, add:
+
+   - **Database (Neon Postgres)**
+   - **Blob Storage (Vercel Blob)**
+   - **Redis (Upstash KV)**
+     All of these are available with free-tier plans.
 
    <img width="1329" alt="step3" src="https://github.com/user-attachments/assets/d0f3848e-e45b-4c20-843e-7c452c297e51" />
 
-4. **Add Environment Variables.**
-   You can enter placeholder values for the environment variables at this stage, or use the actual values if you have them ready. If you prefer, you can enter temporary values now and update them later in the project's settings after deployment is complete. However, **BETTER_AUTH_SECRET** must be set at this stage.
+4. **Set Environment Variables.**
 
-   - You can generate an BETTER_AUTH_SECRET [here](https://auth-secret-gen.vercel.app/).
+   - You must enter a value for **BETTER_AUTH_SECRET** (any random string is fine). You can generate one [here](https://auth-secret-gen.vercel.app/).
+   - Enter your **AI Provider API Key(s)**. Only one is required to start (OpenAI, Google Gemini, or Anthropic Claude).
+   - You can use placeholder values and update them later in **Project Settings > Environments** after deployment.
 
     <img width="1469" alt="step4" src="https://github.com/user-attachments/assets/a0ca9aab-e32a-42ff-8714-707cda387c2a" />
 
-5. **Deployment and Project Creation.**
-   Once the above steps are complete, deployment will begin automatically and your project will be created.
+5. **Deploy your project.**
+   Once everything is set, Vercel will automatically build and deploy your project.
 
-6. **Enter LLM Provider API Keys in Project Settings.**
-   After deployment, go to your project's **Settings > Environments** tab. Here, enter the API keys for the LLM providers you wish to use. You only need to enter the keys for the providers you actually plan to use—other fields can be left blank or filled with dummy values.
+6. **Update API Keys and Settings (optional).**
+   After deployment, go to **Settings > Environments** to add or update your API keys and configuration.
 
    - Example environment file: [example.env](https://github.com/cgoinglove/better-chatbot/blob/main/.env.example)
+   - You can customize authentication, signup/login, and other options by editing your environment variables here.
 
    <img width="1712" alt="step6" src="https://github.com/user-attachments/assets/2d197389-a865-46ac-9156-40cad64258ca" />
 
+---
+
 ## Notes
 
-- Only Remote(sse, streamable) MCP servers are supported (STDIO-based servers are not).
-- If you need STDIO support, consider using Docker or Render.
+- To enable **web search**, you can request an API key from [Exa](https://dashboard.exa.ai). A free tier is available.
+- Only Remote (SSE, Streamable) MCP servers are supported. STDIO-based servers are not supported on Vercel (consider Docker or Render if needed).
+- Check `.env.example` for all available settings.