Documentation

Connect your own API keys. Chat with ChatGPT 5, Claude, Gemini, and 100+ models. Create projects with document storage powered by OpenAI Vector Stores.

Features

Core (Free)

• Multi-provider chat — ChatGPT 5, Claude, Gemini, DeepSeek, 100+ OpenRouter models
• Project management — Organize conversations with OpenAI Vector Stores
• File upload — PDF, DOCX, TXT, code files up to 512MB
• Document search — AI searches uploaded files for contextual answers
• Dark mode — System-aware theme switching
• Encrypted storage — AES-256 encryption for all API keys

Pro

• Unlimited projects — Per-user projects (vs. 5 shared in Free)
• Project sharing — Private, shared, or team-wide access
• Audio transcription — Whisper-1 integration with permanent save
• Prompt library — Save and organize prompts with AI enhancement
• Model comparison — Side-by-side responses from multiple models
• Chat branching — Fork conversations to explore different directions
• Spreadsheet import — Import CSV/Excel data for AI analysis
• Image generation — GPT-Image-1 for creating images
• Priority support — Direct email support

Installation

1. Download the plugin from WordPress.org (Free) or your account (Pro)
2. Upload via Plugins → Add New → Upload Plugin or FTP to /wp-content/plugins/
3. Activate the plugin in WordPress admin
4. Configure API keys at ChatProjects → Settings
5. Add shortcode [chatprojects_main] to any page

Configuration

API Keys

Add at least one API key at ChatProjects → Settings. OpenAI is required for project features (Vector Stores).

Provider	API Key URL
OpenAI	platform.openai.com/api-keys
Anthropic	console.anthropic.com/settings/keys
Google Gemini	ai.google.dev
Chutes	chutes.ai
OpenRouter	openrouter.ai/keys

Usage

Creating a Project

1. Navigate to your ChatProjects page
2. Click Projects → New Project
3. Enter title, description, and optional AI instructions
4. Click Create Project

Each project automatically creates an OpenAI Vector Store for document indexing.

Uploading Files

1. Open a project and go to the Files tab
2. Drag and drop files or click to browse
3. Files are automatically indexed in the Vector Store

Chatting

1. Open a project and go to the Chat tab
2. Select provider and model from dropdowns
3. Type your message and press Enter

The AI will search your uploaded documents when answering questions.

Shortcodes

Shortcode	Description
[chatprojects_main]	Main interface (default view)
[chatprojects_main default_tab="chat"]	Opens to chat tab
[chatprojects_main default_tab="projects"]	Opens to projects list

AI Providers

Provider	Models
OpenAI	ChatGPT 5.1, ChatGPT 5.0, GPT-4o, GPT-4o-mini, o1, o1 Mini
Anthropic	Claude Sonnet 4, Claude 3.5 Sonnet, Claude 3.5 Haiku, Claude 3 Opus
Google	Gemini 2.0 Flash, Gemini 1.5 Pro, Gemini 1.5 Flash
Chutes	DeepSeek V3, DeepSeek R1
OpenRouter	100+ models from various providers

File Support

Supported Types

Category	Extensions
Documents	PDF, DOC, DOCX, TXT, MD
Data	CSV, JSON, XML, HTML
Code	JS, PY, PHP, CSS, Java, C++

Size Limits

• Default: 50MB per file
• Maximum: 512MB (configurable in Settings, limited by OpenAI)

Pro Features

Audio Transcription Pro

Convert audio to text using OpenAI Whisper-1. Supports MP3, WAV, M4A, WEBM (max 25MB). Optionally save transcriptions permanently with AI rewriting in different tones.

Prompt Library Pro

Save and organize prompts with categories. Includes AI-powered prompt enhancement and usage tracking.

Project Sharing Pro

Control access per-project:

• Private — Only owner can access
• Shared — Specific invited users
• Team — All logged-in users

Model Comparison Pro

Send the same prompt to multiple models and compare responses side-by-side.

Chat Branching Pro

Fork any conversation at any point to explore different directions. Create multiple branches from a single message to test alternative prompts or continue conversations in parallel without losing context.

Spreadsheet Import Pro

Import CSV and Excel files directly into chat for AI analysis. The AI can read, summarize, and answer questions about your spreadsheet data. Supports large datasets with automatic chunking.

Image Generation Pro

Generate images using GPT-Image-1 directly in chat. Describe what you want and get high-quality images. Supports standard and HD quality, square and wide aspect ratios.

---

Free vs Pro

Feature	Free	Pro
Projects	5 shared	Unlimited per-user
AI Providers	✓	✓
File Upload & Search	✓	✓
Dark Mode	✓	✓
Encrypted API Keys	✓	✓
Per-User Projects	—	✓
Project Sharing	—	✓
Audio Transcription	—	✓
Prompt Library	—	✓
Model Comparison	—	✓
Chat Branching	—	✓
Spreadsheet Import	—	✓
Image Generation	—	✓
Priority Support	—	✓

Upgrade to Pro →

Security

• AES-256 encryption — API keys encrypted before database storage
• Local storage — Keys never sent to ChatProjects servers
• Direct API calls — Your server communicates directly with AI providers
• WordPress standards — Nonce verification, capability checks, input sanitization
• File validation — Type and size validation on all uploads

FAQ

Do I need all 5 API keys?

No. One key is enough to start. OpenAI is only required for project features (Vector Stores, file search).

Where are API keys stored?

Encrypted with AES-256 in your WordPress database. Never transmitted to external servers except directly to the AI providers.

Can I use ChatProjects without OpenAI?

Yes, for basic chat. You can use Claude, Gemini, or OpenRouter without OpenAI. Project features require OpenAI.

What are the API costs?

ChatProjects uses your own keys — you pay providers directly. Costs vary by model. Vector Store storage is ~$0.10/GB/day.

How do I upgrade to Pro?

Purchase at chatprojects.com/. Deactivate Free, install Pro. Projects and settings are preserved.

Support

• Documentation: chatprojects.com/docs
• Free support: WordPress.org forums
• Pro support: support@chatprojects.com