Merge branch 'jondwillis-feature/auth' into jondwillis-feature/auth-merged

.claude/.gitignore

@@ -1 +0,0 @@
-commands/code/apply-issue-main.md

.claude/commands/aix/roll-aix.md

@@ -1,20 +0,0 @@
----
-description: Increment the AIX monotonic version number
-allowed-tools: Bash(git add:*),Bash(git status:*),Bash(git commit:*),Edit,Write
-model: haiku
-disable-model-invocation: true
----
-
-Increment `Monotonics.Aix` in `src/common/app.release.ts` and commit it.
-
-**Pre-flight checks (MUST pass or abort):**
-1. Run `git branch --show-current` - MUST be on `main` branch
-2. Run `git status src/common/app.release.ts` - file MUST be unmodified (no changes on this specific file)
-
-**Execute:**
-1. Read current `Monotonics.Aix` value from `src/common/app.release.ts`
-2. Increment by 1
-3. Update ONLY that line
-4. Run: `git add src/common/app.release.ts && git commit -m "Roll AIX"`
-
-Confirm new version number.

.claude/commands/aix/sync-anthropic-api.md

@@ -1,31 +0,0 @@
----
-description: Sync Anthropic API implementation with latest upstream documentation
-argument-hint: specific feature to check
----
-
-Please take a look at my API code for Anthropic: message wire types `src/modules/aix/server/dispatch/wiretypes/anthropic.wiretypes.ts`, assembly of the request messages (adapters) `src/modules/aix/server/dispatch/chatGenerate/adapters/anthropic.messageCreate.ts`, and parsing of the response in streaming or not `src/modules/aix/server/dispatch/chatGenerate/parsers/anthropic.parser.ts`.
-
-IMPORTANT: we only support the Messages API (message create). We do NOT support other APIs such as the older Completions API.
-We support Anthropic caching natively, and want to make sure tools and state (crafting the history) are also done well.
-
-Then take a look at the newest API information available. Try these sources, and be creative if some are blocked:
-
-**Primary Sources:**
-- Docs API: https://docs.claude.com/en/api/messages
-- Release notes: https://docs.claude.com/en/release-notes/api
-- Tools use: https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview
-- Handling stop reasons: https://docs.claude.com/en/api/handling-stop-reasons
-
-**Alternative Sources if primary blocked:**
-- Anthropic TypeScript SDK: https://github.com/anthropics/anthropic-sdk-typescript
-- Anthropic Python SDK: https://github.com/anthropics/anthropic-sdk-python
-- Recent news and announcements: Web Search for "anthropic api changelog" or "new claude api" or "new claude api pricing"
-
-**If all blocked:** Explain what you attempted and ask user to provide documentation manually.
-
-$ARGUMENTS
-Check carefully and look if there are any discrepancies in the protocols, the available API surface, the structure of the messages, functionality, logic, etc.
-Make sure you look deep in the fields of the requests and responses, especially required fields, streaming event types, and any new response shapes.
-
-Please point out all of the differences in the API whether it's in the final parsing and reassembly of the streaming message, or the protocol changed, etc.
-Prioritize breaking changes and new capabilities that would improve the user experience.

.claude/commands/aix/sync-gemini-api.md

@@ -1,30 +0,0 @@
----
-description: Sync Google Gemini API implementation with latest upstream documentation
-argument-hint: specific feature to check
----
-
-Please take a look at my API code for Google Gemini: message wire types `src/modules/aix/server/dispatch/wiretypes/gemini.wiretypes.ts`, assembly of the request messages (adapters) `src/modules/aix/server/dispatch/chatGenerate/adapters/gemini.generateContent.ts`, and parsing of the response in streaming or not `src/modules/aix/server/dispatch/chatGenerate/parsers/gemini.parser.ts`.
-
-IMPORTANT: we only support the generateContent API, not other Gemini APIs such as embeddings, etc.
-Caching is only supported when implicit, we do not explicitly manage Gemini Caches. Same for file uploads and other systems.
-Image generation happens through models, i.e. 'Gemini 2.5 Flash - Nano Banana' generates images using AIX from generateContent (chat input).
-
-Then take a look at the newest API information available. Try these sources, and be creative if some are blocked:
-
-**Primary Sources:**
-- Docs API 1/2: https://ai.google.dev/api/generate-content
-- Docs API 2/2: https://ai.google.dev/api/caching#Content
-- Release notes: https://ai.google.dev/gemini-api/docs/changelog
-
-**Alternative Sources if primary blocked:**
-- Google AI JavaScript SDK: https://github.com/googleapis/js-genai (check latest commits, README, type definitions)
-  Recent news and announcements: Web Search for "gemini api changelog" or "nwe gemini api updates" or "new gemini api pricing"
-
-**If all blocked:** Explain what you attempted and ask user to provide documentation manually.
-
-$ARGUMENTS
-Check carefully and look if there are any discrepancies in the protocols, the available API surface, the structure of the messages, functionality, logic, etc.
-Make sure you look deep in the fields of the requests and responses, especially required fields, streaming event types, and any new response shapes.
-
-Please point out all of the differences in the API whether it's in the final parsing and reassembly of the streaming message, or the protocol changed, etc.
-Prioritize breaking changes and new capabilities that would improve the user experience.

.claude/commands/aix/sync-openai-apis.md

@@ -1,34 +0,0 @@
----
-description: Sync OpenAI API implementation with latest upstream documentation
-argument-hint: specific feature to check
----
-
-Please take a look at my API code for OpenAI: message wire types `src/modules/aix/server/dispatch/wiretypes/openai.wiretypes.ts`, assembly of the request messages (adapters) `src/modules/aix/server/dispatch/chatGenerate/adapters/openai.chatCompletions.ts`, and parsing of the response in streaming or not `src/modules/aix/server/dispatch/chatGenerate/parsers/openai.parser.ts`.
-
-IMPORTANT: we prioritize the new Responses API, while Chat Completions is still supported but legacy.
-We do NOT support other APIs such as Realtime (incl. websockets), etc.
-We also do not support Agentic APIs (Agent SDK, AgentKit, ChatKit, Assistants API etc), as we perform similar functionality in AIX (server or client side).
-
-Then take a look at the newest API information available. Try these sources, and be creative if some are blocked:
-
-**Primary Sources:**
-- Responses API (AIX prioritizes it): https://platform.openai.com/docs/api-reference/responses/create
-- Chat Completions API: https://platform.openai.com/docs/api-reference/chat/create
-- Changelog: https://platform.openai.com/docs/changelog
-- Models: https://platform.openai.com/docs/models
-- Pricing (use Copy Page button to download markdown): https://platform.openai.com/docs/pricing
-
-**Alternative Sources if primary blocked:**
-- OpenAI Node.js SDK: https://github.com/openai/openai-node
-- OpenAI Python SDK: https://github.com/openai/openai-python
-- OpenAI OpenAPI spec: https://github.com/openai/openai-openapi
-  Recent news and announcements: Web Search for "openai api changelog" or "openai new models" or "openai new prices"
-
-**If all blocked:** Explain what you attempted and ask user to provide documentation manually.
-
-$ARGUMENTS
-Check carefully and look if there are any discrepancies in the protocols, the available API surface, the structure of the messages, functionality, logic, etc.
-Make sure you look deep in the fields of the requests and responses, especially required fields, streaming event types, and any new response shapes.
-
-Please point out all of the differences in the API whether it's in the final parsing and reassembly of the streaming message, or the protocol changed, etc.
-Prioritize breaking changes and new capabilities that would improve the user experience.

.claude/commands/aix/sync-openrouter-api.md

@@ -1,49 +0,0 @@
----
-description: Sync OpenRouter API implementation with latest upstream documentation
-argument-hint: specific feature to check
----
-
-Review the OpenRouter implementation:
-- Models list: `src/modules/llms/server/openai/openrouter.wiretypes.ts` (list API response schema)
-- Chat wire types: `src/modules/aix/server/dispatch/wiretypes/openai.wiretypes.ts` (OpenAI-compatible)
-- Request adapter: `src/modules/aix/server/dispatch/chatGenerate/adapters/openai.chatCompletions.ts` ('openrouter' dialect)
-- Response parser: `src/modules/aix/server/dispatch/chatGenerate/parsers/openai.parser.ts` (shared OpenAI parser)
-- Vendor config: `src/modules/llms/vendors/openrouter/openrouter.vendor.ts`
-
-GOAL: Ensure complete support for OpenRouter's API including advanced features like reasoning/thinking tokens, tool use, search integration, and multi-modal capabilities. OpenRouter is OpenAI-compatible but has important extensions and differences.
-
-Use Task tool with subagent_type=Explore and thoroughness="very thorough" to discover:
-1. Map API structure - all endpoints, parameters, capabilities from https://openrouter.ai/docs
-2. **Advanced features** - How to use: reasoning/thinking tokens (o1, DeepSeek R1), tool use/function calling, search integration, multi-modal (vision/audio)
-3. Changelog location - How does OpenRouter communicate API updates and breaking changes?
-4. Model metadata - What capabilities are exposed in the models list API? How to detect feature support?
-5. OpenAI deviations - Extensions, special headers (HTTP-Referer, X-Title), response fields, streaming differences
-
-Then check the latest API information. Try these sources (be creative if blocked):
-
-**Primary Sources:**
-- API Reference: https://openrouter.ai/docs/api-reference
-- Chat Completions: https://openrouter.ai/docs/api-reference#chat-completions
-- Models List: https://openrouter.ai/docs/api-reference#models-list
-- Parameters Guide: https://openrouter.ai/docs/parameters
-- Announcements: https://openrouter.ai/announcements (feature launches, API updates, new models)
-- Models Directory: https://openrouter.ai/models (check metadata for capabilities)
-
-**Alternative Sources:**
-- GitHub: https://github.com/OpenRouterTeam (SDKs, examples, issues for recent changes)
-- Web Search: "openrouter api changelog" or "openrouter reasoning tokens" or "openrouter tool use"
-
-**If blocked:** Ask user to provide documentation.
-
-$ARGUMENTS
-Focus on discrepancies and gaps:
-- **Request/Response structure**: New fields, changed requirements, streaming event types
-- **Feature support**: Thinking tokens format, tool calling protocol, search parameters
-- **Model capabilities**: How to detect and enable advanced features per model
-- **OpenRouter extensions**: Headers, routing, fallbacks, rate limiting (free vs paid)
-- **Breaking changes**: Protocol updates, deprecated fields, new required parameters
-
-Report differences in wire types, adapter logic, parser handling, or dialect-specific quirks.
-Prioritize new capabilities that improve user experience (reasoning visibility, better tool use, etc.).
-
-When making changes, add comments with date: `// [OpenRouter, 2026-MM-DD]: explanation`

.claude/commands/aix/sync-xai-api.md

@@ -1,56 +0,0 @@
----
-description: Sync xAI Responses API implementation with latest upstream documentation
-argument-hint: specific feature to check
----
-
-Review the xAI Responses API implementation:
-- xAI wire types: `src/modules/aix/server/dispatch/wiretypes/xai.wiretypes.ts` (xAI-specific request schema, tools)
-- Request adapter: `src/modules/aix/server/dispatch/chatGenerate/adapters/xai.responsesCreate.ts` (AIX → xAI Responses API)
-- Response parser: `src/modules/aix/server/dispatch/chatGenerate/parsers/openai.responses.parser.ts` (shared with OpenAI Responses)
-- Dispatch routing: `src/modules/aix/server/dispatch/chatGenerate/chatGenerate.dispatch.ts` (dialect='xai' routing)
-- OpenAI shared types: `src/modules/aix/server/dispatch/wiretypes/openai.wiretypes.ts` (InputItem/OutputItem schemas reused by xAI)
-
-IMPORTANT context:
-- We use ONLY the xAI Responses API (`POST /v1/responses`). We do NOT use the Chat Completions API (`/v1/chat/completions`) for xAI anymore.
-- xAI's Responses API is similar to OpenAI's but has key differences - the skill should find what changed since our last sync.
-- Response streaming/parsing reuses the OpenAI Responses parser since the format is compatible.
-- We do NOT implement: Files API, Collections Search, Remote MCP tools, Voice Agent API, Image/Video generation, Batch API, or Deferred Completions.
-
-Then take a look at the newest API information available. Try these sources, and be creative if some are blocked:
-
-**Primary Sources (guide pages work well with WebFetch despite being JS-rendered):**
-- Responses API Guide: https://docs.x.ai/docs/guides/chat
-- Stateful Responses: https://docs.x.ai/docs/guides/responses-api
-- Tools Overview: https://docs.x.ai/docs/guides/tools/overview
-- Search Tools (web_search, x_search): https://docs.x.ai/docs/guides/tools/search-tools
-- Code Execution Tool: https://docs.x.ai/docs/guides/tools/code-execution-tool
-- Function Calling: https://docs.x.ai/docs/guides/function-calling
-- Streaming: https://docs.x.ai/docs/guides/streaming-response
-- Reasoning: https://docs.x.ai/docs/guides/reasoning
-- Structured Outputs: https://docs.x.ai/docs/guides/structured-outputs
-- Models & Pricing: https://docs.x.ai/developers/models
-- Release Notes: https://docs.x.ai/developers/release-notes
-- API Reference: https://docs.x.ai/developers/api-reference#create-new-response
-
-**Alternative Sources if primary blocked:**
-- xAI Python SDK: https://github.com/xai-org/xai-sdk-python
-- Web Search for "xai grok api changelog 2026" or "xai responses api new features"
-
-**If all blocked:** Explain what you attempted and ask user to provide documentation manually.
-
-$ARGUMENTS
-Check carefully for discrepancies between our implementation and the current API docs:
-
-1. **Request fields**: Compare `XAIWire_API_Responses.Request_schema` against current docs - any new, changed, or deprecated parameters?
-2. **Tool definitions**: Compare `XAIWire_Responses_Tools` - any new parameters on web_search/x_search/code_interpreter? Any new hosted tool types?
-3. **Input/Output item types**: Any xAI-specific output items not handled by the shared OpenAI parser (e.g., x_search_call, web_search_call, code_interpreter_call)?
-4. **Streaming events**: Any xAI-specific SSE event types beyond what the OpenAI Responses parser handles?
-5. **Response shape**: Usage reporting differences, new fields in the response object?
-6. **Adapter logic**: Message role mapping, content type handling, system message approach - still correct?
-7. **Include options**: Any new values for the `include` array?
-8. **Reasoning config**: Which models support it and with what values?
-
-Prioritize breaking changes and new capabilities that would improve the user experience.
-When making changes, add comments with date: `// [xAI, 2026-MM-DD]: explanation`
-
-**Self-update this skill**: After completing the sync, if your research reveals that assumptions in THIS skill file (`.claude/commands/aix/sync-xai-api.md`) are wrong or outdated - e.g., new APIs we now implement, new tool types added, URLs moved, file paths changed - update this skill file to stay accurate for next time.

.claude/commands/code/grep-history.md

@@ -1,63 +0,0 @@
----
-description: Search git history for commits that introduce or remove an exact string, within a commit range
-argument-hint: "[search-string] [ancestor-commit]"
-allowed-tools: Bash(git *)
----
-
-Search git history using `git log -S` (pickaxe) to find commits that add or remove an exact string.
-This repo has 7000+ commits, so pickaxe searches can take 30-60+ seconds - this is expected.
-
-## Parameters
-
-- `$0` - The exact string to search for in file contents (not commit messages). Examples: `getLabsSUDO`, `EXPERIMENT_ON_SUDO`, `myFunctionName`
-- `$1` - A commit hash or unique commit message substring to identify the start of the range. Examples: `5af80b96a8`, `"Sudo Mode": 10-click`
-
-## Example
-
-```
-/code:grep-history EXPERIMENT_ON_SUDO "Sudo Mode": 10-click
-```
-
-This searches all commits between the `"Sudo Mode": 10-click` commit and HEAD for any that add or remove the string `EXPERIMENT_ON_SUDO` in file contents.
-
-## Procedure
-
-### Step 1: Resolve the ancestor commit
-
-If `$1` looks like a commit hash (hex string), use it directly.
-Otherwise, search for it by message, restricting to ancestors of HEAD:
-
-```bash
-git log --oneline --grep='$1' HEAD | head -5
-```
-
-This only walks commits reachable from HEAD, so every result is a guaranteed ancestor - no verification loop needed.
-
-If multiple results, pick the oldest (last listed) since it represents the earliest matching commit.
-If none, report the error and stop.
-
-### Step 2: Run pickaxe search
-
-```bash
-git log -S "$0" --oneline <resolved_ancestor>..HEAD
-```
-
-This finds commits where the count of `$0` in the codebase changes (i.e., it was added or removed).
-This can be slow on 7000+ commits - wait for it.
-
-### Step 3: Check endpoints
-
-Also check whether the string exists at HEAD and at the ancestor commit:
-
-```bash
-git grep -l "$0" HEAD 2>/dev/null || echo "(not found at HEAD)"
-git grep -l "$0" <resolved_ancestor> 2>/dev/null || echo "(not found at ancestor)"
-```
-
-### Step 4: Report
-
-Present results concisely:
-- Number of commits found (or "none")
-- List of matching commits (hash + subject line)
-- Whether the string exists at HEAD and/or at the ancestor
-- If found, suggest next steps (e.g., `git show <hash>` to inspect specific commits)

.claude/commands/code/review-inflight.md

@@ -1,34 +0,0 @@
----
-description: Review in-flight changes for coherence, completeness, and quality
----
-
-Review the current in-flight changes in the big-agi-private repository (dev branch, continuously rebased ~1800 commits on top of main).
-
-**Step 1: Scope and read**
-
-`git diff --stat` + `git status` for breadth. Then full `git diff` (if empty: `git diff --cached`, then `git diff HEAD~1`).
-For every file in the diff, read surrounding context in the actual source file - the diff alone hides bugs in adjacent untouched code.
-
-**Step 2: Reverse-engineer the intent**
-
-From the diff, determine the **what**, **how**, and **why**. Present this concisely so the author can confirm or correct,
-but don't stop here, continue to the full review in the same response.
-
-**Step 3: Validate**
-
-Run `tsc --noEmit --pretty` and `npm run lint` (in parallel). Report any errors with the review.
-If the diff removes/renames identifiers, grep the codebase for stale references to the OLD names. This catches broken guards, stale imports, and incomplete migrations.
-
-**Step 4: Deep review**
-
-Evaluate every file in the diff.
-Leave no rocks unturned - correctness, coherence, completeness, excess, generalization, maintenance burden,
-codebase consistency, etc.
-
-**Step 5: Prioritized next steps**
-
-Think about what happens when the next developer touches this code.
-Rank findings by severity (bug > correctness > cleanup > cosmetic). Be specific about what to change and where.
-
-Remember: design values for this codebase: orthogonal features, features that generalize well, modularized and reusable code,
-type-discriminated data, optimized code, zero maintenance burden. Minimize future pain, etc.

.claude/commands/code/thread-progress.md

@@ -1,57 +0,0 @@
----
-description: Show a hierarchical progress tree of the current conversation thread
----
-
-Analyze this conversation thread and produce a **hierarchical progress tree** - a vertical breadcrumb of the chat and actions from the very start to now.
-
-**Format:**
-
-A tree, where every rabbithole that was taken adds a level.
-
-```
-[ ] Brief initial phase/ask/goal description
-  [x] Specific thing done or decided - "user quote if relevant"
-  [x] Another step
-  [ ] Sub-phase/rabbithole/etc
-    [x] Done step (if important)
-    [ ] Sub-sub-phase
-      [ ] Current step doing <-- HERE
-      [ ] Next step since this sub-sub-phase was broken out
-
-    [ ] Remaining step
-    [ ] ...
-
-  [ ] Missing, back to the main goal
-  [ ] ...
-  
-### What do we rewind the rabbithole to (once the current level is complete)?
-...
-
-### What's up (towards user value) and down (towards deeper code levels) the rabbithole?
-...
-
-### What's a good hyphenated title for this chat?
-...
-
-```
-
-**Rules:**
-- `[x]` done, `[ ]` not done. Parent is done only when ALL children on the next level are `[x]`
-- Each node: a few words, specific. Quote the user briefly when it captures the intent
-- Group by logical phases or rabbitholes (when descending to a deeper level of implementation or going off for a temporary tangent or sub-quest), not by messages
-- Earlier levels that are fully completed don't need to be expanded in subtasks
-- Root nodes/completed nodes need to show what was "wanted" from them, not being checked because they are shown as earlier phases (i.e. upper hierarchy contains more)
-- Some earlier sub-phases or even levels of rabbitholes can be marked as done as indented [x] below each other (do not add non-major bullets on already completed nodes)
-- Insert newlines in between large groups of items
-- Decisions: state what was chosen, not the alternatives
-- If a former phase produced no code change or decision, omit
-- Very important to insert incomplete `[ ]` items for things that wre mentioned and are likely useful but mentioned at higher levels of the rabbithole so they must come after, when unwinding the stack
-- Keep it short, tight (min 0 max item count below *ONE QUARTER the user messages*). This is a navigation aid, not a transcript
-
-It's important for this to represent a high-level sequence of important actions and turns and pivots and rabbiholes, all focuses on trying to solve something.
-
-First think through it looking at all the chat from the back to the front, then front to back, user requests, and understand the main storybeats. This is useful especially to remove already done leaves that don't add much if shown.
-So think about the full list, so you have it all in front of you when you do the last pass to show it to me.
-It's important to see the progress of what we were doing (e.g. see that we set out to do something at the beginning, but a few items of those are still incomplete, also because we took 2 detours to fix more things in the meantime...).
-
-At the end anser the questions in the Format, with brief bullet points.

.claude/commands/llms/align-params-uis.md

@@ -1,63 +0,0 @@
----
-description: Sync LLM parameter options between full model dialog and chat side panel
----
-
-Audit and sync LLM parameter configurations between the two UI editors. Goal: identical `value` fields in option arrays + equivalent onChange logic. Labels/descriptions can differ for UI space.
-
-**Files to Compare:**
-1. **Full Model Dialog**: `src/modules/llms/models-modal/LLMParametersEditor.tsx` (main branch)
-2. **Chat Side Panel**: `src/apps/chat/components/layout-panel/ChatPanelModelParameters.tsx` (main derived branches only)
-
-**Reference Documentation:**
-- Parameter system: `kb/systems/LLM-parameters-system.md`
-- Parameter registry: `src/common/stores/llms/llms.parameters.ts`
-
-**Task: Perform a comprehensive audit**
-
-1. **Read both files** and extract all option arrays (e.g., `_reasoningEffortOptions`, `_antEffortOptions`, `_geminiThinkingLevelOptions`, etc.)
-
-2. **Check for missing parameters:**
-   - Parameters handled in `LLMParametersEditor.tsx` but NOT in `ChatPanelModelParameters.tsx`
-   - Parameters in `ChatPanelModelParameters.tsx`'s `_interestingParameters` array but missing UI controls
-   - Note: The side panel intentionally shows only "interesting" parameters - focus on those listed in `_interestingParameters`
-
-3. **Check for value mismatches** between corresponding option arrays:
-   - Different number of options (e.g., 3 vs 4 options)
-   - Same label but different `value` (this causes the bug in issue #926)
-   - Different labels for the same `value`
-   - Missing `_UNSPECIFIED`/Default option in one but not the other
-
-4. **Check onChange handler consistency:**
-   - Both should remove parameter on `_UNSPECIFIED` selection
-   - Both should set explicit values the same way
-   - Watch for conditions like `value === 'high'` that may differ
-
-**Output Format:**
-
-```
-## Parameter Sync Audit Report
-
-### Missing Parameters
-- [ ] `llmVndXyz` - In full dialog, missing from side panel
-
-### Value Mismatches
-- [ ] `_xyzOptions`:
-  - Full dialog: [values...]
-  - Side panel: [values...]
-  - Issue: [description]
-
-### Handler Inconsistencies
-- [ ] `llmVndXyz` onChange differs: [explanation]
-
-### Recommended Fixes
-1. [Specific fix with code snippet if needed]
-```
-
-**Fix Direction:** Full dialog is source of truth. Update side panel to match its values when mismatched.
-
-**Notes:**
-- Side panel uses shorter descriptions (space-constrained) - that's fine
-- Variable names may differ (e.g., `_anthropicEffortOptions` vs `_antEffortOptions`) - that's fine, but same is better
-- `value` fields must be identical sets
-- `_UNSPECIFIED` must mean the same thing in both
-- onChange: remove on `_UNSPECIFIED`, set explicit value otherwise

.claude/commands/llms/update-models-alibaba.md

@@ -1,20 +0,0 @@
----
-description: Update Alibaba model definitions with latest pricing and capabilities
----
-
-Update `src/modules/llms/server/openai/models/alibaba.models.ts` with latest model definitions.
-
-Reference `src/modules/llms/server/llm.server.types.ts` and `src/modules/llms/server/models.mappings.ts` for context only. Focus on the model file, do not descend into other code.
-
-**Primary Sources:**
-- Models & Pricing: https://www.alibabacloud.com/help/en/model-studio/models
-- Billing Guide: https://www.alibabacloud.com/help/en/model-studio/billing-for-model-studio
-
-**Fallbacks if blocked:**
-- Search "alibaba model studio latest pricing", "alibaba latest models", "qwen models pricing", or search GitHub for latest model prices and context windows
-
-**Important:**
-- Review the full model list for additions, removals, and price changes
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments to make diffs easy to review
-- Flag broken links or unexpected content

.claude/commands/llms/update-models-anthropic.md

@@ -1,49 +0,0 @@
----
-description: Update Anthropic model definitions with latest pricing and capabilities
----
-
-Update `src/modules/llms/server/anthropic/anthropic.models.ts` with latest model definitions.
-
-Reference files (for context only, do not modify):
-- `src/modules/llms/server/llm.server.types.ts`
-- `src/modules/llms/server/models.mappings.ts`
-- `src/common/stores/llms/llms.parameters.ts`
-
-**Workflow: Start with recent changes, then verify the full model list.**
-
-**Primary Sources (append `.md` to any path for clean markdown):**
-1. Recent changes: https://platform.claude.com/docs/en/release-notes/overview.md
-2. Models & IDs: https://platform.claude.com/docs/en/about-claude/models/overview.md
-3. Pricing (base, cache, batch, long context): https://platform.claude.com/docs/en/about-claude/pricing.md
-4. Deprecations & retirement dates: https://platform.claude.com/docs/en/about-claude/model-deprecations.md
-
-**Discovering feature docs:** The release notes and models overview markdown
-contain inline links to feature-specific pages (thinking modes, effort,
-context windows, what's-new pages, etc.). When a new capability is
-referenced, follow those links - append `.md` to get markdown. Examples of
-pages you might discover this way:
-- `about-claude/models/whats-new-claude-*` - per-generation changes
-- `build-with-claude/extended-thinking` - thinking budget configuration
-- `build-with-claude/effort` - effort parameter levels
-- `build-with-claude/adaptive-thinking` - adaptive thinking mode
-
-**Fallback web pages** (crawl if `.md` paths break or structure changes):
-- https://platform.claude.com/docs/en/about-claude/models/overview
-- https://platform.claude.com/docs/en/about-claude/pricing
-- https://platform.claude.com/docs/en/release-notes/overview
-- https://claude.com/pricing
-
-**Fallbacks if blocked:** Check the Anthropic TypeScript SDK at
-https://github.com/anthropics/anthropic-sdk-typescript, or web-search
-for "anthropic models latest pricing" / "anthropic latest models".
-
-**Important:**
-- Review the full model list for additions, removals, and price changes
-- For new models: check which `parameterSpecs` are needed (thinking mode,
-  effort levels, 1M context, skills, web tools) by reading the linked
-  feature docs and comparing with existing model entries
-- When thinking/effort semantics change between generations
-  (e.g. adaptive vs manual thinking), document in comments
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments to make diffs easy to review
-- Flag broken links or unexpected content

.claude/commands/llms/update-models-deepseek.md

@@ -1,22 +0,0 @@
----
-description: Update DeepSeek model definitions with latest pricing and capabilities
----
-
-Update `src/modules/llms/server/openai/models/deepseek.models.ts` with latest model definitions.
-
-Reference `src/modules/llms/server/llm.server.types.ts` and `src/modules/llms/server/models.mappings.ts` for context only. Focus on the model file, do not descend into other code.
-
-**Primary Sources:**
-- Pricing: https://api-docs.deepseek.com/quick_start/pricing
-- Model List: https://api-docs.deepseek.com/api/list-models
-- Release Notes: https://api-docs.deepseek.com/updates (check for version updates like V3.2-Exp)
-
-**Note:** DeepSeek frequently releases new versions with significant pricing changes. Always check release notes first.
-
-**Fallbacks if blocked:** Search "deepseek api latest pricing", "deepseek latest models", "deepseek models list" or search GitHub for latest model prices and context windows
-
-**Important:**
-- Review the full model list for additions, removals, and price changes
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments to make diffs easy to review
-- Flag broken links or unexpected content

.claude/commands/llms/update-models-dynamic.md

@@ -1,91 +0,0 @@
----
-description: Update/validate dynamic vendor model parsers (OpenRouter, TogetherAI, Alibaba, Azure, Novita, ChutesAI, FireworksAI, TLUS, LM Studio, LocalAI, FastAPI)
----
-
-Validate that the dynamic (API-fetched) vendor model parsers are up to date and not silently broken.
-
-These vendors do NOT have hardcoded model lists - they fetch models from APIs at runtime. But their parsers, filters, heuristic detection, and capability mapping can break if upstream APIs change. This skill covers all dynamic vendors NOT covered by the other `llms:update-models-{vendor}` skills.
-
-## Vendors to Validate
-
-### High Risk
-
-**OpenRouter** - `src/modules/llms/server/openai/models/openrouter.models.ts`
-- Most complex parser. Vendor-specific parameter inheritance (Anthropic thinking variants, Gemini thinking/image, OpenAI reasoning effort, xAI/DeepSeek reasoning).
-- Hardcoded family ordering list (lines ~24-37) - check if new leading vendors are missing.
-- Hardcoded old/deprecated model hiding list (lines ~39-49) - check if stale.
-- Cache pricing detection (Anthropic-style vs OpenAI-style) - verify format still valid.
-- Variant injection for Anthropic thinking/non-thinking - verify still correct.
-- Reference: https://openrouter.ai/docs/models
-
-### Medium Risk
-
-**Novita** - `src/modules/llms/server/openai/models/novita.models.ts`
-- Features array mapping (`function-calling`, `reasoning`, `structured-outputs`) and input modalities parsing.
-- Pricing unit conversion (hundredths of cent per million → dollars per 1K).
-- Hostname heuristic: `novita.ai`.
-
-**ChutesAI** - `src/modules/llms/server/openai/models/chutesai.models.ts`
-- Custom `max_model_len` field for context window.
-- Assumes all models support Vision + Functions (aggressive).
-- Hostname heuristic: `.chutes.ai`.
-
-**FireworksAI** - `src/modules/llms/server/openai/models/fireworksai.models.ts`
-- Relies on provider capability flags: `supports_chat`, `supports_image_input`, `supports_tools`.
-- Hostname heuristic: `fireworks.ai/`.
-
-**TogetherAI** - `src/modules/llms/server/openai/models/together.models.ts`
-- Type allow-list (`type: 'chat'`), vision detection by string match.
-- Custom wire schema with pricing conversion.
-
-**TLUS** - `src/modules/llms/server/openai/models/tlusapi.models.ts`
-- Detected by response structure (`total_models`, `free_models`, `pro_models` fields).
-- Capability enum mapping (`text`, `vision`, `audio`, `tool-calling`, `reasoning`, `websearch`).
-- Tier-based pricing (`free` vs paid).
-
-**Alibaba** - `src/modules/llms/server/openai/models/alibaba.models.ts`
-- Model list was cleared (dynamic-only). Exclusion patterns for non-chat models.
-- Assumes 128K context and Vision+Functions for all models (overly permissive).
-- Check if hardcoded data should be restored now that naming has stabilized.
-
-### Low Risk (local/generic - validate only if issues reported)
-
-**Azure** - `src/modules/llms/server/openai/models/azure.models.ts`
-- Custom deployments API, not `/v1/models`. User-specific. Deployment name fallback logic.
-
-**LM Studio** - `src/modules/llms/server/openai/models/lmstudio.models.ts`
-- Local service, native API (`/api/v1/models`). GGUF metadata parsing, capability flags.
-
-**LocalAI** - `src/modules/llms/server/openai/models/localai.models.ts`
-- Local service. String-based hide list, vision/reasoning detection by name pattern.
-
-**FastAPI** - `src/modules/llms/server/openai/models/fastapi.models.ts`
-- Generic passthrough. Detected by `owned_by === 'fastchat'`. Minimal parsing.
-
-## Validation Checklist
-
-For each vendor (prioritize High > Medium > Low):
-
-1. **Read the parser file** and check for:
-   - Deny/allow lists that may be stale (new model families missing)
-   - Capability assumptions that may be wrong (e.g. "all models support vision")
-   - Field names that may have changed upstream
-   - Pricing conversion math that may use wrong units
-
-2. **Check upstream docs** (where available) for:
-   - API response schema changes
-   - New model types or capability fields
-   - Deprecated fields
-
-3. **Cross-reference with OpenRouter** (aggregator):
-   - OpenRouter surfaces models from many of these vendors
-   - If OpenRouter shows capabilities that a vendor's parser misses, the parser is stale
-
-4. **Fix issues found** - update parsers, filters, deny lists as needed.
-
-5. Run `tsc --noEmit` after changes.
-
-**Important:**
-- Do NOT convert dynamic vendors to hardcoded lists - the dynamic approach is intentional
-- Focus on parser correctness, not model coverage
-- Flag any vendor whose API response format seems to have changed substantially

.claude/commands/llms/update-models-gemini.md

@@ -1,21 +0,0 @@
----
-description: Update Gemini model definitions with latest pricing and capabilities
----
-
-Update `src/modules/llms/server/gemini/gemini.models.ts` with latest model definitions.
-
-Reference `src/modules/llms/server/llm.types.ts`, `src/modules/llms/server/llm.server.types.ts`, and `src/modules/llms/server/models.mappings.ts` for context only. Focus on the model file, do not descend into other code.
-
-**Primary Sources:**
-- Models: https://ai.google.dev/gemini-api/docs/models
-- Pricing: https://ai.google.dev/gemini-api/docs/pricing
-- Changelog: https://ai.google.dev/gemini-api/docs/changelog
-
-**Fallbacks if blocked:** Check Google AI JS SDK at https://github.com/googleapis/js-genai, search "gemini models latest pricing", "gemini latest models", or search GitHub for latest model prices and context windows
-
-**Important:**
-- Ignore context windows (auto-determined at runtime) and training cutoffs (not supported)
-- Review the full model list for additions, removals, and price changes
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments to make diffs easy to review, do NOT remove comments
-- Flag broken links or unexpected content

.claude/commands/llms/update-models-groq.md

@@ -1,19 +0,0 @@
----
-description: Update Groq model definitions with latest pricing and capabilities
----
-
-Update `src/modules/llms/server/openai/models/groq.models.ts` with latest model definitions.
-
-Reference `src/modules/llms/server/llm.server.types.ts` and `src/modules/llms/server/models.mappings.ts` for context only. Focus on the model file, do not descend into other code.
-
-**Primary Source:**
-- Fetch https://console.groq.com/docs/models.md directly (markdown format, no search needed)
-- Pricing: https://groq.com/pricing/
-
-**Do NOT use web search.** The `.md` endpoint provides structured markdown content directly.
-
-**Important:**
-- Review the full model list for additions, removals, and price changes
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments to make diffs easy to review
-- Flag broken links or unexpected content

.claude/commands/llms/update-models-kimi.md

@@ -1,19 +0,0 @@
----
-description: Update Kimi model definitions with latest pricing and capabilities
----
-
-Update `src/modules/llms/server/openai/models/moonshot.models.ts` with latest model definitions.
-
-Reference `src/modules/llms/server/llm.server.types.ts` and `src/modules/llms/server/models.mappings.ts` for context only. Focus on the model file, do not descend into other code.
-
-**Primary Sources (fetch directly, no search needed):**
-- Pricing: https://platform.moonshot.ai/docs/pricing/chat
-- API Reference: https://platform.moonshot.ai/docs/api/chat
-
-**Do NOT use web search.** Fetch the URLs directly, or ask the user to provide data, if unaccessible.
-
-**Important:**
-- Review the full model list for additions, removals, and price changes
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments to make diffs easy to review
-- Flag broken links or unexpected content

.claude/commands/llms/update-models-minimax.md

@@ -1,26 +0,0 @@
----
-description: Update MiniMax model definitions with latest pricing and capabilities
----
-
-Update `src/modules/llms/server/openai/models/minimax.models.ts` with latest model definitions.
-
-Reference `src/modules/llms/server/llm.server.types.ts` and `src/modules/llms/server/models.mappings.ts` for context only. Focus on the model file, do not descend into other code.
-
-**Primary Sources:**
-- Models & Changelog: https://platform.minimax.io/docs/release-notes/models.md
-- Pricing: https://platform.minimax.io/docs/guides/pricing-paygo.md
-- Pricing Overview: https://platform.minimax.io/docs/pricing/overview.md
-- Text Generation API: https://platform.minimax.io/docs/guides/text-generation.md
-
-**Note:** MiniMax is a hardcoded-only vendor (no `/v1/models` API yet). All model IDs, context windows, and pricing must be manually maintained from the docs. Pay attention to new model releases (M-series), highspeed variants, and deprecated models.
-
-**Fallbacks if blocked:** Search "minimax api models pricing", "minimax m2 m3 models", "minimax api changelog" or check https://openrouter.ai models list for MiniMax entries.
-
-**Important:**
-- Models are `ModelDescriptionSchema[]` objects (not ManualMappings) - match existing pattern in the file
-- Review the full model list for additions, removals, and price changes
-- Check for new `-highspeed` variants and new model families
-- Verify context window sizes and max completion tokens against docs
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments to make diffs easy to review
-- Flag broken links or unexpected content

.claude/commands/llms/update-models-mistral.md

@@ -1,24 +0,0 @@
----
-description: Update Mistral model definitions with latest pricing and capabilities
----
-
-Update `src/modules/llms/server/openai/models/mistral.models.ts` with latest model definitions.
-
-Reference `src/modules/llms/server/llm.server.types.ts` and `src/modules/llms/server/models.mappings.ts` for context only. Focus on the model file, do not descend into other code.
-
-**Primary Sources:**
-- Models: https://docs.mistral.ai/getting-started/models/models_overview/
-- Pricing: https://mistral.ai/pricing#api-pricing
-- Changelog: https://docs.mistral.ai/getting-started/changelog/
-
-**Fallbacks if blocked:**
-- Search "mistral [model-name] latest pricing",  "mistral api latest pricing", "mistral latest models", or search GitHub for latest model prices and context windows
-- Cross-reference: pricepertoken.com, helicone.ai, artificialanalysis.ai
-- Check Mistral API list models response
-- As last resort: Use Chrome DevTools MCP to render pricing table
-
-**Important:**
-- Review the full model list for additions, removals, and price changes
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments to make diffs easy to review
-- Flag broken links or unexpected content

.claude/commands/llms/update-models-ollama.md

@@ -1,41 +0,0 @@
----
-description: Update Ollama model definitions with latest featured models
----
-
-Update `src/modules/llms/server/ollama/ollama.models.ts` with latest model definitions.
-
-Reference `src/modules/llms/server/llm.server.types.ts` and `src/modules/llms/server/models.mappings.ts` for context only. Focus on the model file, do not descend into other code.
-
-**Automated Workflow:**
-```bash
-# 1. Fetch the HTML to a cross-platform temp path (sorted by newest for stable ordering)
-curl -s "https://ollama.com/library?sort=newest" -o "$(node -p "require('os').tmpdir()")/ollama-newest.html"
-
-# 2. Parse it with the script (auto-finds the file in os.tmpdir())
-node .claude/scripts/parse-ollama-models.js 2>&1
-```
-
-The parser outputs: `modelName|pulls|capabilities|sizes`
-- Example: `deepseek-r1|66200000|tools,thinking|1.5b,7b,8b,14b,32b,70b,671b`
-
-**Primary Sources:**
-- Model Library: https://ollama.com/library?sort=newest
-- Parser script: `.claude/scripts/parse-ollama-models.js`
-
-**Fallbacks if blocked:** Check https://github.com/ollama/ollama, search "ollama featured models", "ollama latest models", or search GitHub for latest model info
-
-**Important:**
-- Parser filtering rules:
-  - Top 30 newest models are always included (regardless of pull count)
-  - After top 30, only models with 50K+ pulls are included
-  - Models with 'cloud' capability are automatically excluded
-  - Models with 'embedding' capability are automatically excluded
-- Sort them in the EXACT same order as the source (newest first, for stable ordering)
-- Extract tags: 'tools' → hasTools, 'vision' → hasVision, 'embedding' → isEmbeddings (note the 's'), 'thinking' → tags only
-- Extract 'b' tags (1.5b, 7b, 32b) to tags field
-- Set today's date (YYYYMMDD format) for newly added models only
-- Update OLLAMA_LAST_UPDATE constant to today's date
-- Do NOT change dates of existing models
-- Review the full model list for additions, removals, and changes
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments and newlines to make diffs easy to review

.claude/commands/llms/update-models-openai.md

@@ -1,26 +0,0 @@
----
-description: Update OpenAI model definitions with latest pricing and capabilities
----
-
-Update `src/modules/llms/server/openai/models/openai.models.ts` with latest model definitions.
-
-Reference `src/modules/llms/server/llm.server.types.ts` and `src/modules/llms/server/models.mappings.ts` for context only. Focus on the model file, do not descend into other code.
-
-**Manual hint:** For pricing page, expand all tables before copying content.
-
-**Primary Sources:**
-- Models: https://platform.openai.com/docs/models (use Copy Page button)
-- Pricing: https://platform.openai.com/docs/pricing (expand tables first)
-
-**Known Issue:** OpenAI docs block automated access (403 Forbidden). Manual browser access required.
-
-**Fallbacks if blocked:**
-- Search "openai models latest pricing", "openai latest models" for third-party aggregators, or search GitHub for latest model prices and context windows
-- OpenAI Node SDK (https://github.com/openai/openai-node) has limited model metadata only
-- As last resort: Use Chrome DevTools MCP to navigate and extract from official docs
-
-**Important:**
-- Review the full model list for additions, removals, and price changes
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments to make diffs easy to review
-- Flag broken links or unexpected content

.claude/commands/llms/update-models-openpipe.md

@@ -1,19 +0,0 @@
----
-description: Update OpenPipe model definitions with latest pricing and capabilities
----
-
-Update `src/modules/llms/server/openai/models/openpipe.models.ts` with latest model definitions.
-
-Reference `src/modules/llms/server/llm.server.types.ts` and `src/modules/llms/server/models.mappings.ts` for context only. Focus on the model file, do not descend into other code.
-
-**Primary Sources:**
-- Base Models: https://docs.openpipe.ai/base-models
-- Pricing: https://docs.openpipe.ai/pricing/pricing
-
-**Fallbacks if blocked:** Search "openpipe models latest pricing", "openpipe latest models", "openpipe base models", or search GitHub for latest model prices and context windows
-
-**Important:**
-- Review the full model list for additions, removals, and price changes
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments to make diffs easy to review
-- Flag broken links or unexpected content

.claude/commands/llms/update-models-perplexity.md

@@ -1,20 +0,0 @@
----
-description: Update Perplexity model definitions with latest pricing and capabilities
----
-
-Update `src/modules/llms/server/openai/models/perplexity.models.ts` with latest model definitions.
-
-Reference `src/modules/llms/server/llm.server.types.ts` and `src/modules/llms/server/models.mappings.ts` for context only. Focus on the model file, do not descend into other code.
-
-**Primary Sources:**
-- Models: https://docs.perplexity.ai/getting-started/models
-- Pricing: https://docs.perplexity.ai/getting-started/pricing
-- Changelog: https://docs.perplexity.ai/changelog/changelog
-
-**Fallbacks if blocked:** Search "perplexity api latest pricing", "perplexity latest models", or search GitHub for latest model prices and context windows
-
-**Important:**
-- Review the full model list for additions, removals, and price changes
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments to make diffs easy to review
-- Flag broken links or unexpected content

.claude/commands/llms/update-models-xai.md

@@ -1,23 +0,0 @@
----
-description: Update xAI model definitions with latest pricing and capabilities
----
-
-Update `src/modules/llms/server/openai/models/xai.models.ts` with latest model definitions.
-
-Reference `src/modules/llms/server/llm.server.types.ts` and `src/modules/llms/server/models.mappings.ts` for context only. Focus on the model file, do not descend into other code.
-
-**Primary Sources:**
-- Models & Pricing: https://docs.x.ai/docs/models?cluster=us-east-1#detailed-pricing-for-all-grok-models
-
-**Known Issue:** docs.x.ai blocks automated access (403 Forbidden). Use fallbacks below.
-
-**Fallbacks if blocked:**
-- Search "xai grok latest pricing", "xai latest models", "xai api models", or search GitHub for latest model prices and context windows
-- Random sites? https://the-rogue-marketing.github.io/grok-api-latest-llms-pricing-october-2025/ (find a newer version), https://langdb.ai/app/providers/xai/ (browse by model, limited coverage)
-- As last resort: Use Chrome DevTools MCP to access docs.x.ai
-
-**Important:**
-- Review the full model list for additions, removals, and price changes
-- Minimize whitespace/comment changes, focus on content
-- Preserve comments to make diffs easy to review
-- Flag broken links or unexpected content

.claude/commands/llms/verify-parameters.md

@@ -1,66 +0,0 @@
----
-description: Verify model parameterSpecs match API-validated sweep data
-argument-hint: openai | anthropic | gemini | xai (or empty for all)
----
-
-# Verify LLM Parameters
-
-Compare model `parameterSpecs` in definition files against API-validated sweep data.
-
-If `$ARGUMENTS` provided, verify only that dialect, which includes reading the pair of sweep results and model defintions. Otherwise verify all four, and read the pairs in sequence.
-
-## Files
-
-**Sweep results** (source of truth for select parameters):
-- `tools/develop/llm-parameter-sweep/llm-{dialect}-parameters-sweep.json`
-  By the time you see these files, the repo owner has already updated them via `tools/develop/llm-parameter-sweep/sweep.sh` (very long running, 15 min per vendor).
-
-**Model definitions (source of truth for model defintions for the user and application, including constants, interfaces, supported parameters and sometimes allowed parameter values)**:
-- OpenAI: `src/modules/llms/server/openai/models/openai.models.ts`
-- Anthropic: `src/modules/llms/server/anthropic/anthropic.models.ts`
-- Gemini: `src/modules/llms/server/gemini/gemini.models.ts`
-- xAI: `src/modules/llms/server/openai/models/xai.models.ts`
-
-## Task
-
-The sweep data is the source of truth for allowed model parameter values or value ranges, and for the `fn` function-calling capability probe.
-
-For each model in the sweep, verify the model definition exposes exactly those capabilities - no more, no less. This includes:
-- The parameter is present in parameterSpecs
-- The paramId variant covers exactly the values from the sweep, if applicable
-- `LLM_IF_OAI_Fn` in `interfaces` matches `"roundtrip"` in the sweep's `fn` array (see below)
-- etc.
-
-Report models where the definition doesn't match the sweep.
-
-## Parameter Mapping
-
-Example parameter mapping. Note that new parameters may have been added to both the definition, and the sweep.
-The objective of the sweep is to hint at model definition values, but the model definitions are what matters for Big-AGI,
-and need to be carefully updated, otherwise thousands of clients may break.
-
-| Dialect   | Sweep Key                | Model paramId                |
-|-----------|--------------------------|------------------------------|
-| OpenAI    | `oai-reasoning-effort`   | `llmVndOaiEffort`            |
-| OpenAI    | `oai-verbosity`          | `llmVndOaiVerbosity`         |
-| OpenAI    | `oai-image-generation`   | `llmVndOaiImageGeneration`   |
-| OpenAI    | `oai-web-search`         | `llmVndOaiWebSearchContext`  |
-| Anthropic | `ant-effort`             | `llmVndAntEffort`            |
-| Anthropic | `ant-thinking-budget`    | `llmVndAntThinkingBudget`    |
-| Gemini    | `gemini-thinking-level`  | `llmVndGemEffort`            |
-| Gemini    | `gemini-thinking-budget` | `llmVndGeminiThinkingBudget` |
-| xAI       | `xai-web-search`         | `llmVndXaiWebSearch`         |
-
-## Function-Calling Capability (`fn`)
-
-The sweep `fn` array is a capability probe (not a paramId). `"roundtrip"` is the authoritative signal - full tool-call -> response -> coherent follow-up. `LLM_IF_OAI_Fn` in the model's `interfaces` must track `"roundtrip"`: present iff present.
-
-Flag:
-- `"roundtrip"` in sweep but `LLM_IF_OAI_Fn` missing (or vice versa)
-- `fn` contains `"auto"`/`"required"` without `"roundtrip"` - partial capability, call it out
-
-## Output
-
-Report first for every model the expected values from the sweep, then the actual values from the definition, then the mismatches.
-
-Finally make one table for each dialect listing all models with mismatches and the specific issues.

.claude/commands/rel/changelog.md

@@ -1,56 +0,0 @@
----
-description: Generate changelog bullets for big-agi.com/changes
-argument-hint: date like "2026-01-10" or empty for auto-detect
----
-
-Generate changelog bullets for a single entry in https://big-agi.com/changes
-
-**Step 1: Find the starting date**
-
-IMPORTANT: This repo rebases frequently, so commits are INTERLEAVED throughout history.
-New commits can appear at line 10, 500, or 1800. Use AUTHOR DATE (`%ad`) to filter - it's preserved during rebases.
-
-If `$ARGUMENTS` provided, use it as the cutoff date.
-
-If NO argument:
-1. Fetch https://big-agi.com/changes to get the most recent changelog date
-2. Use that date as the cutoff
-
-**Step 2: Get commits by author date**
-
-Filter commits by author date to catch ALL new commits regardless of position in history:
-
-```bash
-# For commits after Jan 10, 2026 (adjust date pattern as needed)
-git log --oneline --no-merges --format="%h %ad %s" --date=short | grep "2026-01-1[1-9]\|2026-01-2\|2026-02"
-
-# Verify interleaving by checking line numbers
-git log --oneline --no-merges --format="%h %ad %s" --date=short | grep -n "2026-01-1[1-9]"
-```
-
-The line numbers prove commits are scattered (e.g., lines 14, 638, 1156, 1803 = interleaved).
-
-**Step 3: Write bullets**
-
-Real examples from big-agi.com/changes:
-- "Gemini 3 Flash support with 4-level thinking: high, medium, low, minimal"
-- "Cloud Sync launched! - long awaited and top requested"
-- "Deepseek V3.2 Speciale comes with almost Gemini 3 Pro performance but 20 times cheaper"
-- "Anthropic Opus 4.5 with controls for effort (speed tradeoff), thinking budget, search"
-- "Login with email, via magic link"
-- "Mobile UX fixes for popups drag/interaction"
-
-**Rules:**
-
-1. **Order by importance** - most significant changes first, minor fixes last
-2. **Feature-first, no verb prefixes** - "Gemini 3 support" not "Add Gemini 3 support"
-3. **Model names lead** when it's about LLMs
-4. **Specific details** - "4-level thinking: high, medium, low, minimal" not "multiple thinking levels"
-5. **One-liners** - short, no fluff
-6. **Consolidate commits** - 10 persona editor commits = 1 bullet
-7. **No corporate speak** - no "enhanced", "streamlined", "robust", "leverage"
-
-**Skip:** WIP, internal refactors, KB docs, automation, review cleanups, trivial fixes, deps bumps, CI changes.
-
-**Output:** Just bullets, ready to paste. 2-5 bullets but adapt depending on scope, especially
-in relation to the usual https://big-agi.com/changes entries.

.claude/commands/rel/release-open.md

@@ -1,149 +0,0 @@
----
-description: Execute the Big-AGI release process
-argument-hint: version like "2.0.4" or empty to auto-increment patch
----
-
-Execute the release process for Big-AGI. Go step-by-step, waiting for user approval between major steps.
-
-## Step 1: Determine Version
-
-If `$ARGUMENTS` provided, use it. Otherwise, read `package.json` and increment patch version.
-
-## Step 2: Gather Context
-
-Before drafting, gather what changed:
-1. `git log --oneline` since last release tag to see all commits
-2. Fetch https://big-agi.com/changes to see what daily entries already covered
-3. `gh issue list --state closed --search "closed:>LAST_RELEASE_DATE"` to find closed issues
-4. Check auto-generated release notes (`gh release create --generate-notes --draft`) for community PRs and new contributors
-
-## Step 3: Update Files
-
-1. **package.json** - Update `version` field
-2. **src/common/app.release.ts** - Increment `Monotonics.NewsVersion` (e.g., 203 → 204)
-3. **src/apps/news/news.data.tsx** - Add new entry at top of `NewsItems` array
-
-For the news entry, ask user for release name and key highlights.
-
-**News entry style** - Draft is a starting point, user will refine:
-- Models lead when model-heavy, grouped together
-- Callout features get own bullet with colon explanation
-- UX items grouped, minimal bold
-- Fixes last, brief
-- Release name stays subtle - don't oversell the theme
-- Apply the draft, then let the user edit manually and re-read after - don't over-iterate
-
-Use `<B>`, `<B issue={N}>`, `<B href='url'>`. Re-read file after user edits.
-
-4. User runs `npm i` to update lockfile
-
-## Step 4: README
-
-Update `README.md`:
-- Line ~46: Update model examples if new flagship models
-- Line ~147: Add release bullet above previous version
-
-**Style:** `- Open X.Y.Z: **Name** feature1, feature2, feature3`
-
-## Step 5: Git Operations
-
-User commits changes, then:
-```bash
-git tag vX.Y.Z
-git push opensource vX.Y.Z
-```
-
-## Step 6: GitHub Release
-
-Create release with `gh release create` using `--notes` (not `--body`).
-
-**Structure** - discursive intro paragraph, then themed sections, not a generic "What's New" header:
-
-```
-# Big-AGI X.Y.Z - Name
-
-### Theme tagline.
-
-1-2 sentence discursive paragraph setting the release theme - what it means, not a feature list.
-
-### Section Name (e.g., Models & Parameters)
-- Bullet points for specifics
-- Group by theme, not by commit order
-
-### Vendor/Platform Section (when enough substance)
-- Give a vendor its own section if 3+ related changes (e.g., Anthropic, AWS Bedrock)
-
-### Also New
-- Remaining features, scannable
-
-## New Contributors
-* @user made their first contribution (brief description) in PR_URL
-
-**Full Changelog**: https://github.com/enricoros/big-AGI/compare/vPREV...vNEW
-
-## Get Started
-Available now at [big-agi.com](https://big-agi.com), via Docker, or self-host from source.
-```
-
-## Step 7: Changelog (big-agi.com/changes)
-
-The Open release entry on big-agi.com/changes is lightweight - just 1-2 bullets announcing the stable release, since daily entries already covered the individual features. Use `/rel:changelog` to generate.
-
-**Style:** `- Open X.Y.Z Name stable release on GitHub and Docker`
-followed by 1 bullet summarizing what landed in the final days since the last daily entry.
-
-## Step 8: Announcements
-
-Draft for user to post:
-
-**Twitter** - Thematic, not feature dumps. Talk about what it means, not what it lists:
-```
-Big-AGI Open X.Y.Z is out!
-
-[Theme - e.g., "Lots of love to models: native support, latest protocols, total configuration - puts you in control."]
-
-[One more angle, natural prose]
-
-[Optional link]
-```
-
-**Discord** - Structured with bold headers:
-```
-## :partyblob: Big-AGI **Open** X.Y.Z
-
-**Category:** Items
-**Category:** Items
-**More:** Count of commits/fixes
-```
-
-## Step 9: Cover Image Prompts
-
-Offer cover image prompt alternatives for the release. Read past prompts from `news.data.tsx` comments (lines ~24-37) for the pattern.
-
-**Pattern:** Always a capybara sculpture made of crystal glass, wearing rayban-like oversized black sunglasses. Each release has a unique theme/activity that symbolizes the release.
-
-**Shared prefix:** `High-key white scene, very clean, hero framing. A close-up photo of a capybara sculpture made of crystal glass. The capybara wears rayban-like oversized black sunglasses.`
-
-**Also offer future release concepts** tied to vision vectors from `kb/vision-inlined.md` (e.g., agency, inhabitation, sculpting, safe exploration).
-
-## Tone Guide
-
-**Good:**
-- "Lots of love to models: native support, latest protocols, total configuration"
-- "UX quality of life improvements, from Google Drive to message reorder"
-- "Gemini 3 Flash support with 4-level thinking: high, medium, low, minimal"
-
-**Bad:**
-- "Rolling out the red carpet for top models!" (too salesy)
-- "Enhanced and streamlined the robust model experience" (corporate speak)
-- "Added support for Gemini 3 Flash model with multiple thinking levels" (verb prefix, vague)
-
-## Reference
-
-Find previous copy at:
-- **GitHub releases:** https://github.com/enricoros/big-AGI/releases
-- **News entries:** `src/apps/news/news.data.tsx`
-- **README:** `README.md` release notes section
-- **Changelog:** https://big-agi.com/changes
-
-Match the existing tone - professional but human, specific not generic, features not marketing.

.claude/scripts/parse-ollama-models.js

@@ -1,115 +0,0 @@
-#!/usr/bin/env node
-/**
- * Parse Ollama models from HTML (sorted by newest for stable ordering)
- *
- * Usage:
- *   1. Fetch HTML: curl -s "https://ollama.com/library?sort=newest" -o /tmp/ollama-newest.html
- *   2. Parse: node .claude/scripts/parse-ollama-models.js
- *
- * Outputs: pipe-delimited format: modelName|pulls|capabilities|sizes
- * Example: deepseek-r1|66200000|tools,thinking|1.5b,7b,8b,14b,32b,70b,671b
- *
- * Filtering rules:
- *   - Top 30 newest models are always included (regardless of pull count)
- *   - After top 30, only models with 50K+ pulls are included
- *   - Models with 'cloud' capability are always excluded
- *   - Models with 'embedding' capability are always excluded
- *
- * Pull counts are rounded to significant figures for stable diffs:
- *   - >=10M: round to 100K (e.g., 109,123,456 -> 109,100,000)
- *   - >=1M:  round to 10K  (e.g., 5,432,100 -> 5,430,000)
- *   - <1M:   round to 1K   (e.g., 88,700 -> 89,000)
- */
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-const htmlPath = process.argv[2] || path.join(os.tmpdir(), 'ollama-newest.html');
-const TOP_N_ALWAYS_INCLUDE = 30;
-const MIN_PULLS_THRESHOLD = 50000;
-
-if (!fs.existsSync(htmlPath)) {
-  console.error(`Error: HTML file not found at ${htmlPath}`);
-  console.error('Please fetch it first with:');
-  console.error('  curl -s "https://ollama.com/library?sort=newest" -o /tmp/ollama-newest.html');
-  process.exit(1);
-}
-
-const html = fs.readFileSync(htmlPath, 'utf8');
-
-// Split into model sections - each starts with <a href="/library/
-const modelSections = html.split(/<a href="\/library\//);
-const allParsedModels = [];
-
-for (let i = 1; i < modelSections.length; i++) {
-  const section = modelSections[i].substring(0, 5000); // Large enough window to capture all data
-
-  // Extract model name (first quoted string)
-  const nameMatch = section.match(/^([^"]+)"/);
-  if (!nameMatch) continue;
-  const name = nameMatch[1];
-
-  // Extract pulls using x-test-pull-count
-  const pullsMatch = section.match(/x-test-pull-count>([^<]+)</);
-  let pulls = 0;
-  if (pullsMatch) {
-    const pullStr = pullsMatch[1].replace(/,/g, '');
-    if (pullStr.includes('M')) {
-      pulls = Math.floor(parseFloat(pullStr) * 1000000);
-    } else if (pullStr.includes('K')) {
-      pulls = Math.floor(parseFloat(pullStr) * 1000);
-    } else {
-      pulls = parseInt(pullStr);
-    }
-  }
-
-  // Extract capabilities (tools, vision, embedding, thinking, cloud)
-  const capabilities = [];
-  const capabilityRegex = /x-test-capability[^>]*>([^<]+)</g;
-  let capMatch;
-  while ((capMatch = capabilityRegex.exec(section)) !== null) {
-    capabilities.push(capMatch[1].trim());
-  }
-
-  // Extract sizes (1.5b, 7b, etc.)
-  const sizes = [];
-  const sizeRegex = /x-test-size[^>]*>([^<]+)</g;
-  let sizeMatch;
-  while ((sizeMatch = sizeRegex.exec(section)) !== null) {
-    sizes.push(sizeMatch[1].trim());
-  }
-
-  // Skip models with 'cloud' or 'embedding' capability
-  if (capabilities.includes('cloud') || capabilities.includes('embedding')) {
-    continue;
-  }
-
-  allParsedModels.push({ name, pulls: roundPulls(pulls), capabilities, sizes });
-}
-
-// Apply filtering: top 30 always included, rest need 50K+ pulls
-const models = allParsedModels.filter((model, index) => {
-  return index < TOP_N_ALWAYS_INCLUDE || model.pulls >= MIN_PULLS_THRESHOLD;
-});
-
-/**
- * Round pulls to significant figures for stable output.
- * This reduces churn from daily fluctuations while preserving magnitude.
- */
-function roundPulls(pulls) {
-  if (pulls >= 10000000) return Math.round(pulls / 100000) * 100000;  // >=10M: round to 100K
-  if (pulls >= 1000000) return Math.round(pulls / 10000) * 10000;     // >=1M: round to 10K
-  return Math.round(pulls / 1000) * 1000;                             // <1M: round to 1K
-}
-
-// Output in pipe-delimited format (in the order they appear on the page)
-models.forEach(m => {
-  const caps = m.capabilities.join(',');
-  const tags = m.sizes.join(',');
-  console.log(`${m.name}|${m.pulls}|${caps}|${tags}`);
-});
-
-const topNCount = Math.min(TOP_N_ALWAYS_INCLUDE, allParsedModels.length);
-const thresholdCount = models.length - topNCount;
-console.error(`\nTotal models: ${models.length} (top ${topNCount} newest + ${thresholdCount} with ${MIN_PULLS_THRESHOLD / 1000}K+ pulls)`);

.claude/settings.local.json

@@ -1,49 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(cat:*)",
-      "Bash(cp:*)",
-      "Bash(curl:*)",
-      "Bash(eslint:*)",
-      "Bash(find:*)",
-      "Bash(gh issue list:*)",
-      "Bash(gh issue view:*)",
-      "Bash(git branch:*)",
-      "Bash(git cherry-pick:*)",
-      "Bash(git describe:*)",
-      "Bash(git grep:*)",
-      "Bash(git log:*)",
-      "Bash(git ls-tree:*)",
-      "Bash(git mv:*)",
-      "Bash(git show:*)",
-      "Bash(grep:*)",
-      "Bash(head:*)",
-      "Bash(ls:*)",
-      "Bash(mkdir:*)",
-      "Bash(node:*)",
-      "Bash(npm install)",
-      "Bash(npm install:*)",
-      "Bash(npm run:*)",
-      "Bash(npx eslint:*)",
-      "Bash(npx tsc:*)",
-      "Bash(rg:*)",
-      "Bash(rm:*)",
-      "Bash(sed:*)",
-      "Bash(tail:*)",
-      "Bash(tree:*)",
-      "Bash(tsc:*)",
-      "Read(//tmp/**)",
-      "Skill(llms:update-models*)",
-      "WebFetch",
-      "WebFetch(domain:big-agi.com)",
-      "WebSearch",
-      "mcp__chrome-devtools",
-      "mcp__github",
-      "mcp__ide__getDiagnostics"
-    ],
-    "deny": [
-      "Read(node_modules)",
-      "Read(node_modules/**)"
-    ]
-  }
-}

.dockerignore

@@ -1,18 +0,0 @@
-*
-
-!app/
-!kb/
-!pages/
-!public/
-!src/
-!tools/
-
-!*.mjs
-!middleware_BASIC_AUTH.ts
-!middleware.ts
-!next.config.ts
-!package*.json
-!tsconfig.json
-
-!LICENSE
-!README.md

.env.example

@@ -0,0 +1,33 @@
+# [Recommended for local deployments] Backend API key for OpenAI, so that users don't need one (UI > this > '')
+OPENAI_API_KEY=
+# [Not needed] Set the backend host for the OpenAI API, to enable platforms such as Helicone (UI > this > api.openai.com)
+OPENAI_API_HOST=
+# [Not needed] Sets the "OpenAI-Organization" header field to support organization users (UI > this > '')
+OPENAI_API_ORG_ID=
+
+# [Optional] Enables ElevenLabs credentials on the server side - for optional text-to-speech
+ELEVENLABS_API_KEY=
+ELEVENLABS_API_HOST=
+ELEVENLABS_VOICE_ID=
+
+# [Optional] Prodia credentials on the server side - for optional image generation
+PRODIA_API_KEY=
+
+# [Optional, Search] Google Cloud API Key
+# https://console.cloud.google.com/apis/credentials -
+GOOGLE_CLOUD_API_KEY=
+# [Optional, Search] Google Custom/Programmable Search Engine ID
+# https://programmablesearchengine.google.com/
+GOOGLE_CSE_ID=
+
+
+# see docs/authentication.md to configure this section
+AUTH_TYPE=
+# [At least one required if AUTH_TYPE == credential] You may declare credentials for users from 0 to 99.
+AUTH_USER_0=
+AUTH_PASSWORD_0=
+
+# [Required if AUTH_TYPE == basic and not in development mode] See: https://next-auth.js.org/configuration/options#nextauth_url
+NEXTAUTH_URL=
+# [Required if AUTH_TYPE == basic] See: https://next-auth.js.org/configuration/options#secret
+NEXTAUTH_SECRET=

.eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": "next/core-web-vitals"
+}

.github/FUNDING.yml

@@ -1,13 +0,0 @@
-# These are supported funding model platforms
-
-github: enricoros # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
-patreon: # Replace with a single Patreon username
-open_collective: # Replace with a single Open Collective username
-ko_fi: # Replace with a single Ko-fi username
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: # Replace with a single Liberapay username
-issuehunt: # Replace with a single IssueHunt username
-otechie: # Replace with a single Otechie username
-lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
-custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/ISSUE_TEMPLATE/ai-triage.yml

@@ -1,70 +0,0 @@
-name: 🔥 Make AI Fix This
-description: Bug, question, or feedback - AI analyzes and changes Big-AGI appropriately
-labels: [ 'claude-triage' ]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Thanks for opening an issue! Our AI will analyze it and change Big-AGI appropriately.
-
-        **What happens next:**
-        - AI searches the codebase and documentation
-        - You get a response, typically within 30 minutes
-        - Ticket gets follow-up and community votes
-
-  - type: textarea
-    attributes:
-      label: What's happening?
-      description: Describe the bug, feature request, or question. Be as detailed as you can.
-      placeholder: |
-        Bug example: "In Beam, Anthropic models seem to have search off..."
-        Model request: "Add Claude Opus 4.5 out today, see https://..."
-        Feature example: "Add the option to to save frequent prompt templates for reuse..."
-    validations:
-      required: true
-
-  - type: dropdown
-    attributes:
-      label: Where does this happen?
-      description: If this is a bug or issue, where are you experiencing it?
-      options:
-        - Big-AGI Pro (big-agi.com)
-        - Self-deployed from GitHub
-        - Docker deployment
-        - Local development
-        - Not applicable (question/feedback)
-        - Other
-    validations:
-      required: false
-
-  - type: dropdown
-    attributes:
-      label: Impact on your workflow
-      description: How does this affect your use of Big-AGI?
-      options:
-        - Blocking - Can't use Big-AGI
-        - High - Major feature broken
-        - Medium - Workaround exists
-        - Low - Minor inconvenience
-        - None - Just a question/suggestion
-    validations:
-      required: false
-
-  - type: textarea
-    attributes:
-      label: Environment (if applicable)
-      description: Device, OS, browser - only if reporting a bug
-      placeholder: |
-        Device: Macbook Pro M3
-        OS: macOS 15.2
-        Browser: Chrome 131
-    validations:
-      required: false
-
-  - type: textarea
-    attributes:
-      label: Additional context
-      description: Screenshots, error messages, or anything else that helps
-      placeholder: Paste screenshots or error messages here
-    validations:
-      required: false

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,49 +0,0 @@
-name: 🐞 Bug Report
-description: Create a report to help us improve
-title: '[BUG]'
-labels: [ 'type: bug' ]
-body:
-  - type: markdown
-    attributes:
-      value: Thank you for reporting a bug. Please help us by providing accurate environment information.
-
-  - type: dropdown
-    attributes:
-      label: Environment
-      description: (required) Where are you experiencing this issue?
-      options:
-        - Big-AGI Pro (big-agi.com)
-        - Self-deployed from GitHub
-        - Docker container (specify in description)
-        - Local development
-        - Other
-    validations:
-      required: true
-
-  - type: textarea
-    attributes:
-      label: Description
-      description: (required) Please provide a clear description and **steps to reproduce**.
-      placeholder: 'Concise description + steps to reproduce.'
-    validations:
-      required: true
-
-  - type: textarea
-    attributes:
-      label: Device and browser
-      description: '(required) Please specify your Mobile/Desktop device, OS version, browser.'
-      placeholder: 'Device: (e.g., iPhone 16, Pixel 9, PC, Macbook...), OS: (e.g., iOS 17, Windows 12), Browser: (e.g., Chrome 119, Safari 18, Firefox..)'
-    validations:
-      required: true
-
-  - type: textarea
-    attributes:
-      label: Screenshots and more
-      placeholder: 'Attach screenshots, or add any additional context here.'
-
-  - type: checkboxes
-    attributes:
-      label: Willingness to Contribute
-      description: We appreciate contributions - would you be willing to submit a pull request?
-      options:
-        - label: '🙋‍♂️ Yes, I would like to contribute a fix.'

.github/ISSUE_TEMPLATE/maintainers-release.md

@@ -1,131 +0,0 @@
----
-name: Maintainers-Release
-about: Maintainers
-title: Release 1.2.3
-labels: ''
-assignees: enricoros
-
----
-
-## Release checklist:
-
-- [x] Create a new [Release Issue](https://github.com/enricoros/big-AGI/issues/new?assignees=enricoros&projects=enricoros/4&template=maintainers-release.md&title=Release+1.2.3)
-  - [ ] Replace 1.1.0 with the _former_ release, and _1.2.3_ with THIS
-- [ ] Update the [Roadmap](https://github.com/users/enricoros/projects/4/views/2) calling out shipped features
-- [ ] Create and update a [Milestone](https://github.com/enricoros/big-agi/milestones) for the release
-  - [ ] Assign this task
-  - [ ] Assign all the shipped roadmap Issues
-  - [ ] Assign the relevant [recently closed Isssues](https://github.com/enricoros/big-agi/issues?q=is%3Aclosed+sort%3Aupdated-desc)
-- Code changes:
-  - [ ] Create a release branch 'release-x.y.z': `git checkout -b release-1.2.3`
-  - [ ] Create a temporary tag `git tag v1.2.3 && git push opensource --tags`
-  - [ ] Create a [New Draft GitHub Release](https://github.com/enricoros/big-agi/releases/new), and generate the automated changelog (for new contributors)
-  - [ ] Update the release version in package.json, and `npm i`
-  - [ ] Update the in-app News version number
-  - [ ] Update in-app News [src/apps/news/news.data.tsx](/src/apps/news/news.data.tsx)
-  - [ ] Update in-app Cover graphics
-  - [ ] Update the README.md with the new release
-  - [ ] Copy the highlights to the [docs/changelog.md](/docs/changelog.md)
-- Release:
-  - [ ] merge onto main `git checkout main && git merge --no-ff release-1.2.3`
-  - [ ] re-tag `git tag -f v1.2.3 && git push opensource --tags -f`
-  - [ ] verify deployment on Vercel
-  - [ ] verify container on GitHub Packages
-  - [ ] update the GitHub release
-- Announce:
-  - [ ] Discord announcement
-  - [ ] Twitter announcement
-
-### Links
-
-- Milestone: https://github.com/enricoros/big-AGI/milestone/X
-- GitHub release: https://github.com/enricoros/big-AGI/releases/tag/v1.2.3
-- Former release task: #...
-
-## Artifacts Generation
-
-```markdown
-You help me generate the following collateral for the new release of my opensource application called big-AGI. The new release is 1.2.3.
-To familiarize yourself with the application, the following are the Website and the GitHub README.md.
-```
-
-- paste the URL: https://big-agi.com
-- drag & drop: [README.md](https://raw.githubusercontent.com/enricoros/big-AGI/main/README.md)
-
-```markdown
-I am announcing a new version, 1.2.3.
-For reference, the following was the collateral for 1.1.0 (Discord announcement, GitHub Release, in-app-news file news.data.tsx).
-```
-
-- paste the former: `discord announcement`,
-- `GitHub release`,
-- `news.data.tsx`,
-- `changelog.md`
-
-```markdown
-The following are the new developments for 1.2.3:
-
-- ...
-- git log --pretty=format:"%h %an %B" v1.1.0..v1.2.3 | clip
-```
-
-- paste the link to the milestone (closed) and each individual issue (content will be downloaded)
-- paste the output of the git log command
-
-### news.data.tsx
-
-```markdown
-I need the following from you:
-
-1. a table summarizing all the new features in 1.2.3 with the following columns: 4 words description (exactly what it is), short description, usefulness (what it does for the user), significance, link to the issue number (not the commit)), which will be used for the artifacts later
-2. then double-check the git log to see if there are any features of significance that are not in the table
-3. then score each feature in terms of importance for users (1-10), relative impact of the feature (1-10, where 10 applies to the broadest user base), and novelty and uniqueness (1-10, where 10 is truly unique and novel from what exists already)
-4. then improve the table, in decreasing order of importance for features, fixing any detail that's missing, in particular check if there are commits of significance from a user or developer point of view, which are not contained in the table
-5. then I want you then to update the news.data.tsx for the new release
-```
-
-### release name
-
-```markdown
-please brainstorm 10 different names for this release. see the former names here: https://big-agi.com/blog
-```
-
-You can follow with 'What do you think of Modelmorphic?' or other selected name
-
-### cover images
-
-```markdown
-Great, now I need to generate images for this. Before I used the following prompts (2 releases before).
-
-// An image of a capybara sculpted entirely from black cotton candy, set against a minimalist backdrop with splashes of bright, contrasting sparkles. The capybara is using a computer with split screen made of origami, split keyboard and is wearing origami sunglasses with very different split reflections. Split halves are very contrasting. Close up photography, bokeh, white background.
-import coverV113 from '../../../public/images/covers/release-cover-v1.13.0.png';
-// An image of a capybara sculpted entirely from black cotton candy, set against a minimalist backdrop with splashes of bright, contrasting sparkles. The capybara is calling on a 3D origami old-school pink telephone and the camera is zooming on the telephone. Close up photography, bokeh, white background.
-import coverV112 from '../../../public/images/covers/release-cover-v1.12.0.png';
-
-What can I do now as far as images? Give me 4 prompt ideas with the same style as looks as the former, but different scene or action
-```
-
-### Readme (and Changelog)
-
-```markdown
-I need you to update the README.md and the with the new release.
-Attaching the in-app news, with my language for you to improve on, but keep the tone.
-```
-
-### GitHub release
-
-```markdown
-Please create the 1.2.3 Release Notes for GitHub, following the format of the 1.1.0 GitHub release notes attached before.
-Use a truthful and honest tone, understanding that people's time and attention span is short.
-Today is 2024-XXXX-YYYY.
-```
-
-Now paste-attachment the former release notes (or 1.5.0 which was accurate and great), including the new contributors and
-some stats (# of commits, etc.), and roll it for the new release.
-
-### Discord announcement
-
-```markdown
-Can you generate my 1.2.3 big-AGI discord announcement from the GitHub Release announcement?
-Please keep the formatting and stye of the discord announcement for 1.1.0, but with the new messaging above.
-```

.github/ISSUE_TEMPLATE/roadmap-request.md

@@ -1,18 +0,0 @@
----
-name: Roadmap request
-about: Suggest a roadmap item
-title: "[Roadmap]"
-labels: ''
-assignees: ''
-
----
-
-**Why**
-(replace this text with yours) The reason behind the request - we love it to be framed for "users will be able to do x" rather than quick-aging hype-tech-of-the-day requests
-
-**Description**
-Clear and concise description of what you want to happen.
-
-**Requirements**
-If you can, Please break-down the changes use cases, UX, technology, architecture, etc.
-- [ ] ...

.github/dependabot.yml

@@ -1,69 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: docker
-    directory: /
-    schedule:
-      interval: weekly
-    commit-message:
-      prefix: "chore(deps)"
-    ignore:
-      - dependency-name: "node"
-        versions: [">=25", "<26"]  # Node 25 breaks the build because of a dummy localStorage object
-
-  - package-ecosystem: github-actions
-    directory: /
-    schedule:
-      interval: weekly
-    commit-message:
-      prefix: "chore(deps)"
-
-# Disabled npm updates for now - will need precise package pinning, as some packages changed behavior upstream
-#  - package-ecosystem: npm
-#    directory: /
-#    schedule:
-#      interval: weekly
-#    commit-message:
-#      prefix: "chore(deps)"
-#    cooldown:
-#      semver-patch: 3
-#      semver-minor: 7
-#      semver-major: 14
-#    # Ignore packages intentionally pinned due to upstream issues
-#    ignore:
-#      # Issue #857: v11.6+ breaks streaming; tried 11.4.4/11.6/11.7, only 11.5.1 works
-#      - dependency-name: "@trpc/*"
-#        versions: [">=11.5.1", "<12"]
-#      # Pinned during tRPC #857 debugging - may be safe to unpin, test first
-#      - dependency-name: "@tanstack/react-query"
-#        versions: [">=5.90.10", "<6"]
-#      # Pinned because 5.0.8 changes signatures so return set({ .. }) != void;
-#      - dependency-name: "zustand"
-#        versions: [">=5.0.7", "<6"]
-#    groups:
-#      next:
-#        patterns:
-#          - "@next/*"
-#          - "eslint-config-next"
-#          - "next"
-#      react:
-#        patterns:
-#          - "react"
-#          - "react-dom"
-#          - "@types/react"
-#          - "@types/react-dom"
-#      emotion:
-#        patterns:
-#          - "@emotion/*"
-#      mui:
-#        patterns:
-#          - "@mui/*"
-#      dnd-kit:
-#        patterns:
-#          - "@dnd-kit/*"
-#      prisma:
-#        patterns:
-#          - "@prisma/*"
-#          - "prisma"
-#      vercel:
-#        patterns:
-#          - "@vercel/*"

.github/workflows/claude-dm.yml

@@ -1,59 +0,0 @@
-name: Claude Code DM
-
-on:
-  issues:
-    types: [opened, assigned]
-  issue_comment:
-    types: [created]
-  pull_request_review:
-    types: [submitted]
-  pull_request_review_comment:
-    types: [created]
-
-jobs:
-  claude-dm:
-    # Only allow repository owner to trigger DMs with @claude (blocks other users and bots)
-    if: |
-      github.actor == 'enricoros' &&
-      github.triggering_actor == 'enricoros' &&
-      ((github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude'))) ||
-      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
-      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
-      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')))
-
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-
-    permissions:
-      contents: write  # Required for code creation and commits
-      issues: write
-      pull-requests: write
-      actions: read # Required for Claude to read CI results on PRs
-      id-token: write # required to use OIDC to authenticate to Claude Code API
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v6
-        with:
-          fetch-depth: 0 # 1 -> 0: full history helps with git blame, etc.
-
-      - name: Run Claude Code DM Response
-        id: claude
-        uses: anthropics/claude-code-action@v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-
-          # Security: Only users with write access can trigger (DMs allow code execution)
-          # Note: contents:write permission enables code creation and commits
-
-          # This is an optional setting that allows Claude to read CI results on PRs
-          additional_permissions: |
-            actions: read
-
-          # Optional: Add claude_args to customize behavior and configuration
-          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
-          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
-          claude_args: |
-            --model claude-opus-4-6
-            --max-turns 100
-            --allowedTools "Edit,Read,Write,WebFetch,WebSearch,Bash(cat:*),Bash(cp:*),Bash(find:*),Bash(git branch:*),Bash(grep:*),Bash(ls:*),Bash(mkdir:*),Bash(npm run:*),Bash(gh issue:*),Bash(gh search:*),Bash(gh label:*),Bash(gh pr:*),SlashCommand"

.github/workflows/claude-issue-triage.yml

@@ -1,83 +0,0 @@
-name: Claude Code Auto-Triage Issues
-
-on:
-  issues:
-    types: [ opened ]
-
-jobs:
-  claude-issue-triage:
-    # Optional: Skip for bot users and direct mentions in the body (handled by claude-dm.yml)
-    if: |
-      github.event.issue.user.type != 'Bot' &&
-      !contains(github.event.issue.body, '@claude')
-
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-
-    permissions:
-      contents: read
-      issues: write
-      pull-requests: read # was write, but we're not altering PRs here
-      actions: read
-      id-token: write # required to use OIDC to authenticate to Claude Code API
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v6
-        with:
-          fetch-depth: 0 # 1 -> 0: full history helps with git blame, etc.
-
-      - name: Analyze issue and provide help
-        uses: anthropics/claude-code-action@v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          # Security: Allow any user to trigger triage (automated issue help is safe)
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          allowed_non_write_users: '*'
-          # track_progress: true # Enables tracking comments
-          show_full_output: ${{ github.event.repository.private }} # security: do not log verbosely in private repo
-
-          # This is an optional setting that allows Claude to read CI results on PRs
-          additional_permissions: |
-            actions: read
-
-          prompt: |
-            REPO: ${{ github.repository }}
-            ISSUE NUMBER: #${{ github.event.issue.number }}
-
-            A user has reported an issue. Please help them by:
-
-            1. Deep think about the issue:
-               **Understand the problem**: Analyze the issue description and any error messages
-               **Search for context**:
-               - Use the repository's CLAUDE.md for high level guidance and especially kb/ documentation
-               - Look in relevant code files, including kb/ documentation
-               **Use web search**: When potentially outside Big-AGI (e.g. user configuration), search the web for similar errors or related issues
-               **Provide a solution**:
-               - Provide multiple solutions if uncertain, and say so
-               - Analyze the code and suggest specific fixes with code examples
-               - If possible also suggest fixes or workarounds for immediate relief
-               - Reference specific files and line numbers
-               - Suggest workarounds for immediate relief if applicable
-               - Use web search to find similar issues and solutions
-               - Test selectively and even npm install and run build if needed to verify the solution
-            2. Always add the 'claude-triage' issue label to indicate this issue was triaged by Claude
-            3. Comment with:
-               - Very brief thank you note, if applicable
-               - Initial assessment
-               - Next steps or clarification needed
-               - Link duplicates if found
-            
-            Remember: design values for this codebase: orthogonal features, features that generalize well, modularized and reusable code,
-            type-discriminated data, optimized code, zero maintenance burden. Minimize future pain, etc.
-
-            IMPORTANT: You are in READ-ONLY triage mode. Analyze and suggest solutions in your comment, but do NOT attempt to push code changes.
-            If you're uncertain, say so and suggest next steps.
-            Be welcoming, helpful, professional, solution-focused and no-BS.
-
-          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
-          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
-          claude_args: |
-            --model claude-opus-4-6
-            --max-turns 75
-            --allowedTools "Edit,Read,Write,WebFetch,WebSearch,Bash(cat:*),Bash(cp:*),Bash(find:*),Bash(git branch:*),Bash(grep:*),Bash(ls:*),Bash(mkdir:*),Bash(npm run:*),Bash(gh issue:*),Bash(gh search:*),Bash(gh label:*),Bash(gh pr:*),SlashCommand"

.github/workflows/docker-image.yml

@@ -7,135 +7,29 @@
 # To get a newer version, you will need to update the SHA.
 # You can also reference a tag or branch, but the action may change without warning.
 
-name: Create and publish Docker images
+name: Create and publish a Docker image
 
 on:
   push:
-    branches:
-      - main          # Primary branch (Big-AGI Open)
-    tags:
-      - 'v2.*'        # Stable releases (v2.0.0, v2.1.0, etc.)
+    branches: ['main']
 
 env:
   REGISTRY: ghcr.io
   IMAGE_NAME: ${{ github.repository }}
 
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
 jobs:
-  # Build job: runs on native runners for each platform (no QEMU emulation)
-  build:
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - platform: linux/amd64
-            runner: ubuntu-latest
-          - platform: linux/arm64
-            runner: ubuntu-24.04-arm
-
-    runs-on: ${{ matrix.runner }}
-    name: Build ${{ matrix.platform }}
-    timeout-minutes: 30
-
-    permissions:
-      contents: read
-      packages: write
-
-    steps:
-      - name: Prepare
-        run: |
-          platform=${{ matrix.platform }}
-          echo "PLATFORM_PAIR=${platform//\//-}" >> $GITHUB_ENV
-          echo "IMAGE_NAME_LC=${IMAGE_NAME,,}" >> $GITHUB_ENV
-
-      - name: Checkout repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
-        with:
-          fetch-depth: 1
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@4d04d5d9486b7bd6fa91e7baf45bbb4f8b9deedd # v4.0.0
-
-      - name: Log in to the Container registry
-        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121 # v4.1.0
-        with:
-          registry: ${{ env.REGISTRY }}
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Extract metadata for Docker
-        id: meta
-        uses: docker/metadata-action@030e881283bb7a6894de51c315a6bfe6a94e05cf # v6.0.0
-        with:
-          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
-          labels: |
-            org.opencontainers.image.title=Big-AGI Open
-            org.opencontainers.image.description=Big-AGI Open - Multi-model AI workspace for experts who need to think broader, decide smarter, and build with confidence.
-            org.opencontainers.image.source=${{ github.server_url }}/${{ github.repository }}
-            org.opencontainers.image.documentation=https://big-agi.com
-
-      - name: Build and push by digest
-        id: build
-        uses: docker/build-push-action@bcafcacb16a39f128d818304e6c9c0c18556b85f # v7.1.0
-        with:
-          context: .
-          file: Dockerfile
-          platforms: ${{ matrix.platform }}
-          labels: ${{ steps.meta.outputs.labels }}
-          tags: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME_LC }}
-          build-args: |
-            NEXT_PUBLIC_GA4_MEASUREMENT_ID=${{ secrets.GA4_MEASUREMENT_ID }}
-            NEXT_PUBLIC_BUILD_HASH=${{ github.sha }}
-            NEXT_PUBLIC_BUILD_REF_NAME=${{ github.ref_name }}
-          outputs: type=image,push-by-digest=true,name-canonical=true,push=true,oci-mediatypes=true
-          provenance: false
-          cache-from: type=gha,scope=${{ github.repository }}-${{ matrix.platform }}
-          cache-to: type=gha,scope=${{ github.repository }}-${{ matrix.platform }},mode=max
-
-      - name: Export digest
-        run: |
-          mkdir -p ${{ runner.temp }}/digests
-          digest="${{ steps.build.outputs.digest }}"
-          touch "${{ runner.temp }}/digests/${digest#sha256:}"
-
-      - name: Upload digest
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: digests-${{ env.PLATFORM_PAIR }}
-          path: ${{ runner.temp }}/digests/*
-          if-no-files-found: error
-          retention-days: 1
-
-  # Merge job: combines platform-specific images into a unified multi-arch manifest
-  merge:
-    name: Merge manifests
+  build-and-push-image:
     runs-on: ubuntu-latest
-    timeout-minutes: 10
-    needs: build
-
     permissions:
       contents: read
       packages: write
 
     steps:
-      - name: Prepare
-        run: echo "IMAGE_NAME_LC=${IMAGE_NAME,,}" >> $GITHUB_ENV
-
-      - name: Download digests
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
-        with:
-          path: ${{ runner.temp }}/digests
-          pattern: digests-*
-          merge-multiple: true
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@4d04d5d9486b7bd6fa91e7baf45bbb4f8b9deedd # v4.0.0
+      - name: Checkout repository
+        uses: actions/checkout@v3
 
       - name: Log in to the Container registry
-        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121 # v4.1.0
+        uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1
         with:
           registry: ${{ env.REGISTRY }}
           username: ${{ github.actor }}
@@ -143,34 +37,14 @@ jobs:
 
       - name: Extract metadata (tags, labels) for Docker
         id: meta
-        uses: docker/metadata-action@030e881283bb7a6894de51c315a6bfe6a94e05cf # v6.0.0
+        uses: docker/metadata-action@9ec57ed1fcdbf14dcef7dfbe97b2010124a938b7
         with:
           images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
-          tags: |
-            # Development: main branch
-            type=raw,value=development,enable=${{ github.ref == 'refs/heads/main' }}
 
-            # Latest: v2.x releases (safe default)
-            type=raw,value=latest,enable=${{ startsWith(github.ref, 'refs/tags/v2.') }}
-
-            # Stable: v2.x releases (alias)
-            type=raw,value=stable,enable=${{ startsWith(github.ref, 'refs/tags/v2.') }}
-
-            # Version tags (v2.0.0, 2.0.0)
-            type=ref,event=tag
-            type=semver,pattern={{version}}
-
-      - name: Create manifest list and push
-        working-directory: ${{ runner.temp }}/digests
-        run: |
-          docker buildx imagetools create \
-            $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< "$DOCKER_METADATA_OUTPUT_JSON") \
-            --annotation='index:org.opencontainers.image.title=Big-AGI Open' \
-            --annotation='index:org.opencontainers.image.description=Big-AGI Open - Multi-model AI workspace for experts who need to think broader, decide smarter, and build with confidence.' \
-            --annotation='index:org.opencontainers.image.source=${{ github.server_url }}/${{ github.repository }}' \
-            --annotation='index:org.opencontainers.image.documentation=https://big-agi.com' \
-            $(printf '${{ env.REGISTRY }}/${{ env.IMAGE_NAME_LC }}@sha256:%s ' *)
-
-      - name: Inspect image
-        run: |
-          docker buildx imagetools inspect ${{ env.REGISTRY }}/${{ env.IMAGE_NAME_LC }}:${{ steps.meta.outputs.version }}
+      - name: Build and push Docker image
+        uses: docker/build-push-action@f2a1d5e99d037542a71f64918e516c093c6f3fc4
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

.gitignore

@@ -1,12 +1,5 @@
 # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
 
-# Frontend Build: ignore API files disabled for this build
-/app/**/*.backup
-
-# Supabase - ignored for now
-/supabase/
-/*.sql
-
 # dependencies
 /node_modules
 /.pnp
@@ -17,7 +10,6 @@
 
 # next.js
 /.next/
-/dist/
 /out/
 
 # production
@@ -34,8 +26,7 @@ yarn-error.log*
 .pnpm-debug.log*
 
 # local env files
-.env
-.env.*
+.env*.local
 
 # vercel
 .vercel
@@ -45,14 +36,4 @@ yarn-error.log*
 next-env.d.ts
 
 # other
-.idea/
-
-# Ingore k8s/env-secret.yaml
-./k8s/env-secret.yaml
-/certificates
-.env*.local
-/.run/dev (ENV).run.xml
-/src/modules/3rdparty/aider/scratch*
-
-# Ignore temporary CC files
-/tmpclaude*
+.idea/

.npmrc

@@ -0,0 +1,3 @@
+overrides=@mui/material@^5.0.0:
+  dependencies:
+    @mui/material: replaced-by=@mui/joy

.nvmrc

@@ -1 +0,0 @@
-24

.prettierrc

@@ -1,7 +1,6 @@
 {
-  "singleAttributePerLine": false,
   "singleQuote": true,
   "trailingComma": "all",
   "endOfLine": "lf",
   "printWidth": 160
-}
+}

AGENTS.md

@@ -1 +0,0 @@
-CLAUDE.md

CLAUDE.md

@@ -1,249 +0,0 @@
-# CLAUDE.md
-
-Guidance to Claude Code when working with code in this repository.
-
-
-## Architecture Overview
-
-Big-AGI is a Next.js 15 application with a sophisticated modular architecture built for professional AI interactions.
-
-### Development Commands
-
-Dev servers may be already running on ports 3000, 3001, 3002, or 3003 (not always this app - other projects may occupy these ports). Never start or stop dev servers, let the user do it.
-
-```bash
-# Validate (~5s, safe while dev server runs, do NOT use `next build` ~45s for same checks)
-tsc --noEmit --pretty && npm run lint # Type check (~3.5s) + ESLint (~2s)
-eslint src/path/to/file.ts           # Lint specific file
-
-# Full build (~60s+, only when suspecting runtime/bundle issues)
-npm run build  # next build runs compile+lint+types but stops at first type-error file; tsc shows all at once
-
-# Database & External Services
-# npm run supabase:local-update-types   # Generate TypeScript types
-# npm run stripe:listen                 # Listen for Stripe webhooks
-```
-
-### Git/GitHub remotes
-
-The `gh` command is available to interact with GitHub from the terminal, but **NEVER PUSH TO ANY BRANCH**. The user manages all 'write' git operations.
-- `opensource` -> `enricoros/big-AGI` (public, default branch: `main`, MIT) - community issues/PRs/releases
-- `private` -> `big-agi/big-agi-private` (private, default branch: `dev`) - main dev repo with `dev`->`staging`->`prod` pipeline
-- **Always use `git mv` instead of `mv`** when renaming or moving files - preserves git history tracking
-- **NEVER run `git stash`** - it causes work loss
-
-**Branch contents:**
-- `main` is the open-source build: local-first, BYO-keys, full AIX and provider coverage
-- `dev` extends `main` with the hosted/cloud layer: auth, Zync sync, Cloud Fabric, Stripe, multi-tenant, admin pages, it's the way to go for users, the best user experience of any multi-model chat application
-- Cloud/auth/sync code stays on `dev`; non-cloud improvements (UX, AIX, model support, bug fixes) can land on either branch
-
-**Branch workflow:**
-- `dev` is rebased on top of `main` (never merged) - `main` changes flow into `dev` on the next rebase, no manual forward-port needed
-- Never `git merge` between the two branches - breaks the linear topology
-- Backporting `dev` -> `main` is a re-implementation, never a cherry-pick - keep `main`-side edits minimal/additive so the existing `dev` version lands cleanly on rebase; split into small commits when natural
-
-### Core Directory Structure
-
-You are started from the root of the repository (i.e. where the git folder is or scripts should be run from).
-**ISSUE ALL COMMANDS FROM THE ROOT, OMITTING 'cd' COMMANDS. DO NOT CHAIN CD AND OTHER COMMANDS**
-**NEVER RUN COMPOUND `cd` COMMANDS LIKE `cd some-folder && command` - ONLY RUN `command` FROM THE ROOT, ALWAYS.**
-The directory structure is as follows:
-
-```
-/app/api/          # Next.js App Router (API routes only, mostly -> /src/server/)
-/pages/            # Next.js Pages Router (file-based, mostly -> /src/apps/)
-/src/
-├── apps/          # Feature applications (self-contained modules)
-├── modules/       # Reusable business logic and integrations
-├── common/        # Shared infrastructure and utilities
-└── server/        # Backend API layer with tRPC
-/kb/               # Knowledge base for modules, architectures
-```
-
-### Key Technologies
-
-- **Frontend**: Next.js 15, React 18, Material-UI Joy, Emotion (CSS-in-JS)
-- **State Management**: Zustand with localStorage/IndexedDB (single cell) persistence
-- **API Layer**: tRPC with TanStack React Query for type-safe communication
-- **Runtime**: Edge Runtime for AI operations, Node.js for data processing
-
-### "Apps" Architecture Pattern
-
-Each app in `/src/apps/` is a self-contained feature module:
-- Main component (`App*.tsx`)
-- Local state store (`store-app-*.ts`)
-- Feature-specific components and layouts
-- Runtime configurations
-
-Example apps: `chat/`, `call/`, `beam/`, `draw/`, `personas/`, `settings-modal/`
-
-### Modules Architecture Pattern
-
-Modules in `/src/modules/` provide reusable business logic:
-- **`aix/`** - AI communication framework for real-time streaming
-- **`beam/`** - Multi-model AI reasoning system (scatter/gather pattern)
-- **`blocks/`** - Content rendering (markdown, code, images, etc.)
-- **`llms/`** - Language model abstraction supporting 20+ vendors
-
-### Key Subsystems & Their Patterns
-
-#### AIX - Real-time AI Communication
-**Location**: `/src/modules/aix/`
-**Pattern**: Client-server streaming architecture with provider abstraction
-
-- **Client** -> tRPC -> **Server** -> **AI Providers**
-- Handles streaming/non-streaming responses with batching and error recovery
-- Particle-based streaming: `AixWire_Particles` -> `ContentReassembler` -> `DMessage`
-- Provider-agnostic through adapter pattern (OpenAI, Anthropic, Gemini protocols)
-
-#### Beam - Multi-Model Reasoning
-**Location**: `/src/modules/beam/`
-**Pattern**: Scatter/Gather for parallel AI processing
-
-- **Scatter**: Multiple models (rays) process input in parallel
-- **Gather**: Fusion algorithms combine outputs
-- Real-time UI updates via vanilla Zustand stores
-- BeamStore per conversation via ConversationHandler
-
-#### Conversation Management
-**Location**: `/src/common/stores/chat/` and `/src/common/chat-overlay/`
-**Pattern**: Overlay architecture with handler per conversation
-
-- `ConversationHandler` orchestrates chat, beam, ephemerals
-- Per-chat stores: `PerChatOverlayStore` + `BeamStore`
-- Message structure: `DMessage` -> `DMessageFragment[]`
-- Supports multi-pane with independent conversation states
-
-#### Layout System ("Optima")
-
-The Optima layout system provides:
-- **Responsive design** adapting desktop/mobile
-- **Drawer(left)/Toolbar/Panel(right)** composition
-- **Portal-based rendering** for flexible component placement
-
-Located in `/src/common/layout/optima/`
-
-### Storage System
-
-Big-AGI uses a local-first architecture with Zustand + IndexedDB:
-- **Zustand** stores for in-memory state management
-- **localStorage** for persistent settings/all storage (via Zustand persist middleware)
-- **IndexedDB** for persistent chat-only storage (via Zustand persist middleware) on a single key-val cell
-- **Local-first** architecture with offline capability
-
-Key storage patterns:
-- Stores use `createIDBPersistStorage()` for IndexedDB persistence
-- Version-based migrations handle data structure changes
-- Partialize/merge functions control what gets persisted
-- Rehydration logic repairs and upgrades data on load
-
-Located in `/src/common/stores/` with stores like:
-- `chat/store-chats.ts`: Conversations and messages
-- `llms/store-llms.ts`: Model configurations
-
-### State Management Patterns
-
-1. **Global Stores** (Zustand with IndexedDB persistence)
-   - `store-chats`: Conversations and messages
-   - `store-llms`: Model configurations
-   - `store-ux-labs`: UI preferences and labs features
-   - **Zustand pattern**: Always wrap multi-property selectors with `useShallow` from `zustand/react/shallow` to prevent re-renders on reference changes
-
-2. **Per-Instance Stores** (Vanilla Zustand)
-   - `store-beam_vanilla`: Beam scatter/gather state
-   - `store-perchat_vanilla`: Chat overlay state
-   - `store-attachment-drafts_vanilla`: Attachment drafts
-   - High-performance, no React integration
-
-3. **Module Stores**
-   - Feature-specific configuration and state
-   - Example: `store-module-beam`, `store-module-t2i`
-
-### User Flows & Interdependencies
-
-#### Chat Message Flow
-1. User input -> `Composer` -> `DMessage` creation
-2. `ConversationHandler.messageAppend()` -> Store update
-3. `_handleExecute()` / `ConversationHandler.executeChatMessages()` -> AIX client request
-4. AIX streaming -> `ContentReassembler` -> UI updates
-5. Zustand auto-persistence -> IndexedDB
-
-#### Beam Multi-Model Flow
-1. User triggers Beam -> `BeamStore.open()` state update
-2. Scatter: Parallel `aixChatGenerateContent()` to N models
-3. Real-time ray updates -> UI progress
-4. Gather: User selects fusion -> Combined output
-5. Result -> New message in conversation
-
-### Development Patterns
-
-#### TypeScript & Code Quality
-- Type-safe through strict TypeScript interfaces
-- Clear interface-first approach for modules and components
-- Use latest TypeScript 5.9+ features
-- Use forward-looking patterns to minimize future refactors (e.g., discriminated unions, `satisfies` operator, as const assertions)
-- Type guards and exhaustiveChecks for robustness
-- Type inference where possible
-- Runtime validation with Zod schemas for API inputs/outputs (usually server-side, with the client importing as types the inferred types)
-
-#### Module Integration
-- Modules register with central registries (e.g., `vendors.registry.ts`)
-- Configuration objects define module behavior
-
-#### API Patterns
-- **tRPC routers** for type-safe API endpoints
-- **Zod schemas** for runtime validation
-- **tRPC procedures middleware** for authorization and logging (authorization is on a httpOnly cookie)
-- **Edge functions** for performance-critical operations
-
-#### Security Considerations
-- API keys in environment variables only (server-side); on the client they're in localStorage for now, but we want to move away from this
-- XSS protection through proper content escaping
-
-#### Writing Style
-- **Never use emdashes (—).** Use normal dashes (-) instead, in all generated text, code comments, and documentation.
-
-
-## Common Development Tasks
-
-### Testing & Quality
-- Run `npm run lint` before committing
-- Type-check with `tsc --noEmit`
-- Test critical user flows manually
-
-### Debugging Storage Issues
-- Check IndexedDB: DevTools -> Application -> IndexedDB -> `app-chats`
-- Monitor Zustand state: Use Zustand DevTools
-- Check migration logs in console during rehydration
-
-
-## Server Architecture
-
-The server uses a split architecture with two tRPC routers:
-
-### Edge Network (`trpc.router-edge`)
-Distributed edge runtime for low-latency AI operations:
-- **AIX** [1] - AI streaming and communication
-- **LLM Routers** [1] - Vendor-specific operations such as list models (OpenAI, Anthropic, Gemini, Ollama)
-- **Speex** [1] - Unified TTS router (ElevenLabs, Inworld, and other TTS vendors)
-- **External Services** - Google Search, YouTube transcripts
-
-[1]: also supports client-side fetch (CSF) via client-side inclusion (rebundling with stubs),
-for direct browser-to-API communication when possible (CORS), to reduce latency and network barriers
-
-Located at `/src/server/trpc/trpc.router-edge.ts`
-
-### Cloud Network (`trpc.router-cloud`)
-Centralized server for data processing operations:
-- **Browse** - Web scraping and content extraction
-- **Trade** - Import/export functionality (ChatGPT, markdown, JSON)
-
-Located at `/src/server/trpc/trpc.router-cloud.ts`
-
-**Key Pattern**: Edge runtime for AI (fast, distributed), Cloud runtime for data ops (centralized, Node.js)
-
-@kb/KB.md
-
-@kb/vision-inlined.md
-
-As a side note, the product tiers (independent, non-VC-funded) are: **Open** (self-host, MIT) · **Free** (big-agi.com) · **Pro** (paid, includes Sync + backup). All tiers use the user's own API keys.

Dockerfile

@@ -1,91 +1,41 @@
-# syntax=docker/dockerfile:1
-# check=skip=CopyIgnoredFile
-
-# Base
-FROM node:24-alpine AS base
-ENV NEXT_TELEMETRY_DISABLED=1
-
-# Dependencies
-FROM base AS deps
-WORKDIR /app
-
-# Dependency files
-COPY package*.json ./
-COPY src/server/prisma ./src/server/prisma
-
-# link ssl3 for latest Alpine
-RUN sh -c '[ ! -e /lib/libssl.so.3 ] && ln -s /usr/lib/libssl.so.3 /lib/libssl.so.3 || echo "Link already exists"'
-
-# Install dependencies, including dev (release builds should use npm ci)
+# Test
+FROM node:18-alpine as test-target
 ENV NODE_ENV=development
-RUN npm ci
+ENV PATH $PATH:/usr/src/app/node_modules/.bin
 
+WORKDIR /usr/src/app
 
-# Builder
-FROM base AS builder
-WORKDIR /app
+COPY package*.json ./
 
-# Deployment type marker
-ENV NEXT_PUBLIC_DEPLOYMENT_TYPE=docker
+# CI and release builds should use npm ci to fully respect the lockfile.
+# Local development may use npm install for opportunistic package updates.
+ARG npm_install_command=ci
+RUN npm $npm_install_command
 
-# Optional build version arguments at build time
-ARG NEXT_PUBLIC_BUILD_HASH
-ENV NEXT_PUBLIC_BUILD_HASH=${NEXT_PUBLIC_BUILD_HASH}
-ARG NEXT_PUBLIC_BUILD_REF_NAME
-ENV NEXT_PUBLIC_BUILD_REF_NAME=${NEXT_PUBLIC_BUILD_REF_NAME}
-
-# Optional argument to configure GA4 at build time (see: docs/deploy-analytics.md)
-ARG NEXT_PUBLIC_GA4_MEASUREMENT_ID
-ENV NEXT_PUBLIC_GA4_MEASUREMENT_ID=${NEXT_PUBLIC_GA4_MEASUREMENT_ID}
-
-# Optional argument to configure PostHog at build time (see: docs/deploy-analytics.md)
-ARG NEXT_PUBLIC_POSTHOG_KEY
-ENV NEXT_PUBLIC_POSTHOG_KEY=${NEXT_PUBLIC_POSTHOG_KEY}
-
-# Optional argument to configure Google Drive Picker at build time (can reuse AUTH_GOOGLE_ID value)
-ARG NEXT_PUBLIC_GOOGLE_DRIVE_CLIENT_ID
-ENV NEXT_PUBLIC_GOOGLE_DRIVE_CLIENT_ID=${NEXT_PUBLIC_GOOGLE_DRIVE_CLIENT_ID}
-
-# Copy development deps and source
-COPY --from=deps /app/node_modules ./node_modules
 COPY . .
 
-# Build the application
+# Build
+FROM test-target as build-target
 ENV NODE_ENV=production
+
+# Use build tools, installed as development packages, to produce a release build.
 RUN npm run build
 
-# Reduce installed packages to production-only
-RUN npm prune --omit=dev
+# Reduce installed packages to production-only.
+RUN npm prune --production
 
-
-# Runner
-FROM base AS runner
-WORKDIR /app
-
-# As user
-RUN addgroup --system --gid 1001 nodejs \
- && adduser --system --uid 1001 nextjs \
- && apk add --no-cache openssl
-
-# Copy Built app
-COPY --from=builder --chown=nextjs:nodejs /app/public ./public
-COPY --from=builder --chown=nextjs:nodejs /app/node_modules ./node_modules
-COPY --from=builder --chown=nextjs:nodejs /app/src/server/prisma ./src/server/prisma
-# Instead of `COPY --from=builder --chown=nextjs:nodejs /app/.next ./.next`, we only extract some parts, excluding .next/cache which is build time only:
-COPY --from=builder --chown=nextjs:nodejs /app/.next/BUILD_ID ./.next/
-COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
-COPY --from=builder --chown=nextjs:nodejs /app/.next/server ./.next/server
-COPY --from=builder --chown=nextjs:nodejs /app/.next/types ./.next/types
-COPY --from=builder --chown=nextjs:nodejs /app/.next/*.json ./.next/
-
-# Minimal ENV for production
+# Archive
+FROM node:18-alpine as archive-target
 ENV NODE_ENV=production
+ENV PATH $PATH:/usr/src/app/node_modules/.bin
 
-# Run as non-root user
-USER nextjs
+WORKDIR /usr/src/app
+
+# Include only the release build and production packages.
+COPY --from=build-target /usr/src/app/node_modules node_modules
+COPY --from=build-target /usr/src/app/.next .next
 
 # Expose port 3000 for the application to listen on
 EXPOSE 3000
 
-# Start the application
-CMD ["/app/node_modules/.bin/next", "start"]
+CMD ["next", "start"]

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023-2026 Enrico Ros
+Copyright (c) 2023 Enrico Ros
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,396 +1,135 @@
-<div align="center">
+# `BIG-AGI` 🤖💬
 
-<img width="256" height="256" alt="Big-AGI Logo" src="https://big-agi.com/assets/logo-bright-github.svg" />
+Welcome to `big-AGI`, FKA `nextjs-chatgpt-app`. 👋🎉
+Personal AGI App, powered by `OpenAI GPT-4` and beyond. Designed for smart humans and super-heroes,
+this responsive web app comes with Personas, Drawing, Code Execution, PDF imports, Voice support,
+data Rendering, AGI functions, chats and more. Show your friends some `#big-AGI-energy` 🚀
 
-<h1><a href="https://big-agi.com">Big-AGI</a></h1>
+[![Official Website](https://img.shields.io/badge/BIG--AGI.com-%23096bde?style=for-the-badge&logo=vercel&label=demo)](https://big-agi.com)
 
-[![Use Free ⋅ Go Pro](https://img.shields.io/badge/Use_Free-Get_Pro-d5ec31?style=for-the-badge&logo=rocket&logoColor=white&labelColor=000)](https://big-agi.com)
-[![Deploy on Docker](https://img.shields.io/badge/Self--Host-Docker-blue?style=for-the-badge&logo=docker&logoColor=white&labelColor=000)](https://github.com/enricoros/big-AGI/pkgs/container/big-agi)
-[![Deploy on Vercel](https://img.shields.io/badge/Vercel-Deploy-blue?style=for-the-badge&logo=vercel&logoColor=white&labelColor=000)](https://vercel.com/new/clone?repository-url=https://github.com/enricoros/big-agi)
-[![Discord](https://img.shields.io/discord/1098796266906980422?style=for-the-badge&label=Discord&logo=discord&logoColor=white&labelColor=000000&color=purple)](https://discord.gg/MkH4qj2Jp9)
-<br/>
-[![GitHub Monthly Commits](https://img.shields.io/github/commit-activity/m/enricoros/big-agi?style=for-the-badge&x=3&logo=github&logoColor=white&label=commits&labelColor=000&color=green)](https://github.com/enricoros/big-agi/commits)
-[![GHCR Pulls](https://img.shields.io/badge/ghcr.io-800k_dl-12b76a?style=for-the-badge&logo=Xdocker&logoColor=white&labelColor=000&color=A8E6CF)](https://github.com/enricoros/big-AGI/pkgs/container/big-agi)
-[![Contributors](https://img.shields.io/github/contributors/enricoros/big-agi?style=for-the-badge&x=2&logo=Xgithub&logoColor=white&label=cooks&labelColor=000&color=A8E6CF)](https://github.com/enricoros/big-AGI/graphs/contributors)
-[![License: MIT](https://img.shields.io/badge/License-MIT-A8E6CF?style=for-the-badge&labelColor=000)](https://opensource.org/licenses/MIT)
-<br/>
+Or fork & run on Vercel
 
-[![Open an Issue](https://img.shields.io/badge/Open_Issue-AI_Will_Help-ff8c00?style=for-the-badge&logo=fireship&logoColor=fff&labelColor=8b0000)](https://github.com/enricoros/big-agi/issues/new?template=ai-triage.yml)
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fenricoros%2Fbig-agi&env=OPENAI_API_KEY,OPENAI_API_HOST&envDescription=OpenAI%20KEY%20for%20your%20deployment.%20Set%20HOST%20only%20if%20non-default.)
 
-[//]: # ([![Uptime Robot ratio &#40;30 days&#41;]&#40;https://img.shields.io/uptimerobot/ratio/m801796948-868b22ed7ceaa0acac4dc765?style=for-the-badge&labelColor=000&color=green&#41;]&#40;https://stats.uptimerobot.com/59MXcnmjrM&#41;)
-[//]: # ([![Open Version]&#40;https://img.shields.io/github/v/release/enricoros/big-AGI?label=Open+Release&style=flat-square&logo=github&logoColor=white&labelColor=000&#41;]&#40;https://github.com/enricoros/big-AGI/releases/latest&#41;)
-[//]: # (![GitHub Stars]&#40;https://img.shields.io/github/stars/enricoros/big-agi?style=flat-square&logo=github&logoColor=white&labelColor=000&color=yellow&#41;)
-[//]: # ([![GitHub Forks]&#40;https://img.shields.io/github/forks/enricoros/big-agi?style=flat-square&logo=github&logoColor=white&labelColor=000&#41;]&#40;#&#41;)
-[//]: # ([![Follow on X]&#40;https://img.shields.io/twitter/follow/enricoros?style=flat-square&logo=X&logoColor=white&labelColor=000&color=000&#41;]&#40;https://x.com/enricoros&#41;)
+## Useful 👊
 
-</div>
+![Ask away, paste a ton, copy the gems](docs/pixels/big-AGI-compo1.png)
 
-<br/>
+- Engaging AI Personas
+- Clean UX, w/ tokens counters
+- Privacy: user-owned API keys and localStorage
+- Human I/O: Advanced voice support (TTS, STT)
+- Machine I/O: PDF import & Summarization, code execution
+- Many more updates & integrations: ElevenLabs, Helicone, Paste.gg, Prodia
+- Coming up: automatic-AGI reasoning
 
-# Big-AGI Open 🧠
-
-This is the open-source foundation of **Big-AGI**, ___the multi-model AI workspace for experts___.
-
-Big-AGI is the multi-model AI workspace for experts: Engineers architecting systems. Founders making decisions. Researchers validating hypotheses.
-You need to think broader, decide faster, and build with confidence, then you need Big-AGI.
-
-It comes packed with **world-class features** like Beam, and is praised for its **best-in-class AI chat UX**.
-**As an independent, non-VC-funded project, Pro subscriptions at $10.99/mo fund development for everyone, including the free and open-source tiers.**
-
-![LLM Vendors](https://img.shields.io/badge/20+_LLM_Services-500+_Models-black?style=for-the-badge&logo=anthropic&logoColor=white&labelColor=purple)&nbsp;
-[![Feature Beam](https://img.shields.io/badge/AI--Validation-BEAM-000?style=for-the-badge&labelColor=purple)](https://big-agi.com/beam)&nbsp;
-[![Feature Inspector](https://img.shields.io/badge/Expert_Mode-AI_Inspector-000?style=for-the-badge&labelColor=purple)](https://big-agi.com/inspector)
-
-### What makes Big-AGI different:
-
-**Intelligence**: with [Beam & Merge](https://big-agi.com/beam) for multi-model de-hallucination, native search, and bleeding-edge AI models like Opus 4.7, Nano Banana Pro, Kimi K2.6 or GPT 5.4 -
-**Control**: with personas, data ownership, requests inspection, unlimited usage with API keys, and *no vendor lock-in* -
-and **Speed**: with a local-first, over-powered, zero-latency, madly optimized web app.
-
-<table>
-<tr>
-<td align="center" width="25%">
-<b>🧠 Intelligence</b><br/>
-<img src="https://img.shields.io/badge/Multi--Model-Trust-4285F4?style=for-the-badge" alt="Multi-Model"/>
-</td>
-<td align="center" width="25%">
-<b>✨ Experience</b><br/>
-<img src="https://img.shields.io/badge/Clean-UX-34A853?style=for-the-badge" alt="Clean UX"/>
-</td>
-<td align="center" width="25%">
-<b>⚡ Performance</b><br/>
-<img src="https://img.shields.io/badge/Zero-Latency-EA4335?style=for-the-badge" alt="Zero Latency"/>
-</td>
-<td align="center" width="25%">
-<b>🔒 Control</b><br/>
-<img src="https://img.shields.io/badge/No-Lock--in-FBBC04?style=for-the-badge" alt="No Lock-in"/>
-</td>
-</tr>
-<tr>
-<td align="center" valign="top">
-Beam & Merge<br/>
-No context junk<br/>
-Purest AI outputs
-</td>
-<td align="center" valign="top">
-Flow-state interface<br/>
-Highly customizable<br/>
-Best-in-class UX
-</td>
-<td align="center" valign="top">
-Local-first<br/>
-Highly parallel<br/>
-Madly optimized
-</td>
-<td align="center" valign="top">
-No vendor lock-in<br/>
-Your API keys<br/>
-AI Inspector
-</td>
-</tr>
-</table>
-
-### Who uses Big-AGI:  
-Loved by engineers, founders, researchers, self-hosters, and IT departments for its power, reliability, and transparency.
-
-<img width="830" height="370" alt="image" src="https://github.com/user-attachments/assets/513c4f77-0970-4a56-b23b-1416c8246174" />
-
-Choose Big-AGI because you don't need another clone or slop - you need an AI tool that scales with you.
-
-### Show me a screenshot:
-Sure - here is real-world screeengrab as I'm writing this, while running a Beam to extract SVG from an image with Sonnet 4.5, Opus 4.1, GPT 5.1, Gemini 2.5 Pro, Nano Banana, etc.  
-<img alt="Real-world screen capture as of Nov 15 2025, 2am" src="https://github.com/user-attachments/assets/853f4160-27cb-4ac9-826b-402f1e63d4af" />
-
-
-## Get Started
-
-| Tier                                                 | Best For          | What You Get                                                  | Setup       |
-|------------------------------------------------------|-------------------|---------------------------------------------------------------|-------------|
-| Big-AGI Open (self-host)                             | **IT**            | First to get new models support. Maximum control and privacy. | 5-30 min    |
-| [big-agi.com](https://big-agi.com) Free              | **Everyone**      | Full core experience, improved Beam, new Personas, best UX.   | **2 min**\* |
-| **[big-agi.com](https://big-agi.com) Pro** $10.99/mo | **Professionals** | Everything + **Sync** across unlimited devices + 1GB storage  | **2 min**\* |
-
-\*: **Configuration requires your API keys**. *Big-AGI does not charge for model usage or limit your access*.  
-**Why Pro?** As an independent project, Pro subscriptions fund all development. Early subscribers shape the roadmap directly.    
-
-[![Use Free ⋅ Go Pro](https://img.shields.io/badge/Use_Free-Get_Pro-d5ec31?style=for-the-badge&logo=rocket&logoColor=white&labelColor=000)](https://big-agi.com)
-
-**Self-host and developers** (full control)  
-- Develop locally or self-host with Docker on your own infrastructure – [guide](docs/installation.md)  
-- Or fork & run on Vercel:  
-  [![Deploy on Vercel](https://img.shields.io/badge/Deploy-black?style=for-the-badge&logo=vercel&logoColor=white&labelColor=000)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fenricoros%2Fbig-AGI&env=OPENAI_API_KEY&envDescription=Backend%20API%20keys%2C%20optional%20and%20may%20be%20overridden%20by%20the%20UI.&envLink=https%3A%2F%2Fgithub.com%2Fenricoros%2Fbig-AGI%2Fblob%2Fmain%2Fdocs%2Fenvironment-variables.md&project-name=big-AGI)
-
-[//]: # (**For the latest Big-AGI:**)
-
-[//]: # (- [**Big-AGI Open**]&#40;https://github.com/enricoros/big-AGI/tree/main&#41; - Open Source, latest models and features &#40;main branch&#41;)
-
-[//]: # (- [**Big-AGI Pro**]&#40;https://big-agi.com&#41; - Hosted with Cloud Sync)
-
----
-
-## Our Philosophy
-
-We're an independent, non-VC-funded project with a simple belief: **AI should elevate you, not replace you**.
-
-This is why we built Big-AGI to be **local-first**, madly optimized to 0-latency, launched multi-model first to
-defeat hallucinations, designed Beam around the **humans in the loop**, re-wrote frameworks and abstractions
-so you **are not vendor locked-in**, and obsessed over a powerful UI that works, just works.
-
-NOTE: this is a powerful tool - if you need a toy UI or clone, this ain't it.
-
-
----
-
-## Release Notes
-
-👉 **[See the Live Release Notes](https://big-agi.com/changes)**
-- Open 2.0.4: **Hyper Params** **Opus 4.6**, **GPT-5.4**, **Gemini 3.1 Pro**, AWS Bedrock, parameter accuracy, Anthropic continuation/Fast mode
-- Open 2.0.3: **Red Carpet** **Kimi K2.5**, **Gemini 3 Flash**, **GPT 5.2**, Google Drive, Inworld, Novita.ai, Speech/UX improvements
-- Open 2.0.2: **Speex** multi-vendor speech synthesis, **Opus 4.5**, **Gemini 3 Pro**, **Nano Banana Pro**, **Grok 4.1**, **GPT-5.1**, **Kimi K2** + 280 fixes
-
-### What's New in 2.0 · Oct 31, 2025 · Open
-
-- **Big-AGI Open** is ready and more productive and faster than ever, with:
-- **Beam 2**: multi-modal, program-based, follow-ups, save presets
-- Top-notch AI models support including **agentic models** and **reasoning models**
-- **Image Generation** and editing with Nano Banana and gpt-image-1
-- **Web Search** with citations for supported models
-- **UI** & Mobile UI overhaul with peeking and side panels
-- And all of the [Big-AGI 2 changes](https://github.com/enricoros/big-AGI/issues/567#issuecomment-2262187617) and more
-- Built for the future, madly optimized
-
-<img width="830" height="385" alt="image" src="https://github.com/user-attachments/assets/ad52761d-7e3f-44d8-b41e-947ce8b4faa1" />
-
-#### **Open** links: 👉 [changelog](https://big-agi.com/changes) 👉 [installation](docs/installation.md) 👉 [roadmap](https://github.com/users/enricoros/projects/4/views/2) 👉 [documentation](docs/README.md)
-
-**For teams and institutions:** Need shared prompts, SSO, or managed deployments? Reach out at enrico@big-agi.com. We're actively collecting requirements from research groups and IT departments.
-
-<details>
-<summary>5,000 Commits Milestone</summary>
-
-Hit 5k commits last week. That's a lot of code.
-
-Recent work has been intense:
-- Chain of thought reasoning across multiple LLMs: **OpenAI o3** and o1, **DeepSeek R1**, **Gemini 2.0 Flash Thinking**, and more
-- Beam is real - ~35% of our users run it daily to compare models
-- New AIX framework lets us scale features we couldn't before
-- UI is faster than ever. Like, terminal-fast
-
-The new architecture is solid and the speed improvements are real.
-
-![5000e-830px](https://github.com/user-attachments/assets/42f7420b-9331-421b-9a18-2e653aaa7d9b)
-
-</details>
-
-<details>
-<summary>What's New in 1.16.1...1.16.13 · (patch releases)</summary>
-
-- 1.16.13: Docker fix ([#840](https://github.com/enricoros/big-AGI/issues/840))
-- 1.16.12: Dockerfile update ([#840](https://github.com/enricoros/big-AGI/issues/840))
-- 1.16.11: v1 final release, documentation updates
-- 1.16.10: OpenRouter models support
-- 1.16.9: Docker Gemini fix, R1 models support
-- 1.16.8: OpenAI ChatGPT-4o Latest, o1 models support
-- 1.16.7: OpenAI support for GPT-4o 2024-08-06
-- 1.16.6: Groq support for Llama 3.1 models
-- 1.16.5: GPT-4o Mini support
-- 1.16.4: 8192 tokens support for Claude 3.5 Sonnet
-- 1.16.3: Anthropic Claude 3.5 Sonnet model support
-- 1.16.2: Improve web downloads, as text, markdown, or HTML
-- 1.16.2: Proper support for Gemini models
-- 1.16.2: Added the latest Mistral model
-- 1.16.2: Tokenizer support for gpt-4o
-- 1.16.2: Updates to Beam
-- 1.16.1: Support for the new OpenAI GPT-4o 2024-05-13 model
-
-</details>
-
-<details>
-<summary>What's New in 1.16.0 · May 9, 2024 · Crystal Clear</summary>
-
-- [Beam](https://big-agi.com/blog/beam-multi-model-ai-reasoning) core and UX improvements based on user feedback
-- Chat cost estimation 💰 (enable it in Labs / hover the token counter)
-- Save/load chat files with Ctrl+S / Ctrl+O on desktop
-- Major enhancements to the Auto-Diagrams tool
-- YouTube Transcriber Persona for chatting with video content, [#500](https://github.com/enricoros/big-AGI/pull/500)
-- Improved formula rendering (LaTeX), and dark-mode diagrams, [#508](https://github.com/enricoros/big-AGI/issues/508), [#520](https://github.com/enricoros/big-AGI/issues/520)
-- Models update: **Anthropic**, **Groq**, **Ollama**, **OpenAI**, **OpenRouter**, **Perplexity**
-- Code soft-wrap, chat text selection toolbar, 3x faster on Apple silicon, and more [#517](https://github.com/enricoros/big-AGI/issues/517), [507](https://github.com/enricoros/big-AGI/pull/507)
-
-</details>
-
-<details>
-<summary>3,000 Commits Milestone · April 7, 2024</summary>
-
-![big-AGI Milestone](https://github.com/enricoros/big-AGI/assets/32999/47fddbb1-9bd6-4b58-ace4-781dfcb80923)
-
-- 🥇 Today we <b>celebrate commit 3000</b> in just over one year, and going stronger 🚀
-- 📢️ Thanks everyone for your support and words of love for Big-AGI, we are committed to creating the best AI experiences for everyone.
-
-</details>
-
-<details>
-<summary>What's New in 1.15.0 · April 1, 2024 · Beam</summary>
-
-- ⚠️ [**Beam**: the multi-model AI chat](https://big-agi.com/blog/beam-multi-model-ai-reasoning). find better answers, faster - a game-changer for brainstorming, decision-making, and creativity. [#443](https://github.com/enricoros/big-AGI/issues/443)
-- Managed Deployments **Auto-Configuration**: simplify the UI models setup with backend-set models. [#436](https://github.com/enricoros/big-AGI/issues/436)
-- Message **Starring ⭐**: star important messages within chats, to attach them later. [#476](https://github.com/enricoros/big-AGI/issues/476)
-- Enhanced the default Persona
-- Fixes to Gemini models and SVGs, improvements to UI and icons
-- 1.15.1: Support for Gemini Pro 1.5 and OpenAI Turbo models
-- Beast release, over 430 commits, 10,000+ lines changed: [release notes](https://github.com/enricoros/big-AGI/releases/tag/v1.15.0), and changes [v1.14.1...v1.15.0](https://github.com/enricoros/big-AGI/compare/v1.14.1...v1.15.0)
-
-</details>
-
-<details>
-<summary>What's New in 1.14.1 · March 7, 2024 · Modelmorphic</summary>
-
-- **Anthropic** [Claude-3](https://www.anthropic.com/news/claude-3-family) model family support. [#443](https://github.com/enricoros/big-AGI/issues/443)
-- New **[Perplexity](https://www.perplexity.ai/)** and **[Groq](https://groq.com/)** integration (thanks @Penagwin). [#407](https://github.com/enricoros/big-AGI/issues/407), [#427](https://github.com/enricoros/big-AGI/issues/427)
-- **[LocalAI](https://localai.io/models/)** deep integration, including support for [model galleries](https://github.com/enricoros/big-AGI/issues/411)
-- **Mistral** Large and Google **Gemini 1.5** support
-- Performance optimizations: runs [much faster](https://x.com/enricoros/status/1756553038293303434?utm_source=localhost:3000&utm_medium=big-agi), saves lots of power, reduces memory usage
-- Enhanced UX with auto-sizing charts, refined search and folder functionalities, perfected scaling
-- And with more UI improvements, documentation, bug fixes (20 tickets), and developer enhancements
-
-</details>
-
-<details>
-<summary>What's New in 1.13.0 · Feb 8, 2024 · Multi + Mind</summary>
-
-https://github.com/enricoros/big-AGI/assets/32999/01732528-730e-41dc-adc7-511385686b13
-
-- **Side-by-Side Split Windows**: multitask with parallel conversations. [#208](https://github.com/enricoros/big-AGI/issues/208)
-- **Multi-Chat Mode**: message everyone, all at once. [#388](https://github.com/enricoros/big-AGI/issues/388)
-- **Export tables as CSV**: big thanks to @aj47. [#392](https://github.com/enricoros/big-AGI/pull/392)
-- Adjustable text size: customize density. [#399](https://github.com/enricoros/big-AGI/issues/399)
-- Dev2 Persona Technology Preview
-- Better looking chats with improved spacing, fonts, and menus
-- More: new video player, [LM Studio tutorial](https://github.com/enricoros/big-AGI/blob/main/docs/config-local-lmstudio.md) (thanks @aj47), [MongoDB support](https://github.com/enricoros/big-AGI/blob/main/docs/deploy-database.md) (thanks @ranfysvalle02), and speedups
-
-</details>
-
-<details>
-<summary>What's New in 1.12.0 · Jan 26, 2024 · AGI Hotline</summary>
-
-https://github.com/enricoros/big-AGI/assets/32999/95ceb03c-945d-4fdd-9a9f-3317beb54f3f
-
-- **Voice Calls**: real-time voice call your personas out of the blue or in relation to a chat [#354](https://github.com/enricoros/big-AGI/issues/354)
-- Support **OpenAI 0125** Models. [#364](https://github.com/enricoros/big-AGI/issues/364)
-- Rename or Auto-Rename chats.  [#222](https://github.com/enricoros/big-AGI/issues/222), [#360](https://github.com/enricoros/big-AGI/issues/360)
-- More control over **Link Sharing** [#356](https://github.com/enricoros/big-AGI/issues/356)
-- **Accessibility** to screen readers [#358](https://github.com/enricoros/big-AGI/issues/358)
-- Export chats to Markdown [#337](https://github.com/enricoros/big-AGI/issues/337)
-- Paste tables from Excel [#286](https://github.com/enricoros/big-AGI/issues/286)
-- Ollama model updates and context window detection fixes [#309](https://github.com/enricoros/big-AGI/issues/309)
-
-</details>
-
-<details>
-<summary>What's New in 1.11.0 · Jan 16, 2024 · Singularity</summary>
-
-https://github.com/enricoros/big-AGI/assets/1590910/a6b8e172-0726-4b03-a5e5-10cfcb110c68
-
-- **Find chats**: search in titles and content, with frequency ranking. [#329](https://github.com/enricoros/big-AGI/issues/329)
-- **Commands**: command auto-completion (type '/'). [#327](https://github.com/enricoros/big-AGI/issues/327)
-- **[Together AI](https://www.together.ai/products#inference)** inference platform support (good speed and newer models). [#346](https://github.com/enricoros/big-AGI/issues/346)
-- Persona Creator history, deletion, custom creation, fix llm API timeouts
-- Enable adding up to five custom OpenAI-compatible endpoints
-- Developer enhancements: new 'Actiles' framework
-
-</details>
-
-<details>
-<summary>What's New in 1.10.0 · Jan 6, 2024 · The Year of AGI</summary>
-
-- **New UI**: for both desktop and mobile, sets the stage for future scale. [#201](https://github.com/enricoros/big-AGI/issues/201)
-- **Conversation Folders**: enhanced conversation organization. [#321](https://github.com/enricoros/big-AGI/issues/321)
-- **[LM Studio](https://lmstudio.ai/)** support and improved token management
-- Resizable panes in split-screen conversations.
-- Large performance optimizations
-- Developer enhancements: new UI framework, updated documentation for proxy settings on browserless/docker
-
-</details>
-
-For full details and former releases, check out the [archived versions changelog](docs/changelog.md).
-
-## 👉 Supported Models & Integrations
-
-Delightful UX with latest models exclusive features like Beam for **multi-model AI validation**.
-> ![LLM Vendors](https://img.shields.io/badge/20_LLM_Services-500+_Models-black?style=for-the-badge&logo=openai&logoColor=white&labelColor=purple)&nbsp;
-> [![Feature Beam](https://img.shields.io/badge/AI--Validation-BEAM-000?style=for-the-badge&logo=anthropic&labelColor=purple)](https://big-agi.com/beam)
-
-| ![Advanced AI](https://img.shields.io/badge/Advanced%20AI-32383e?style=for-the-badge&logo=ai&logoColor=white) | ![500+ AI Models](https://img.shields.io/badge/500%2B%20AI%20Models-32383e?style=for-the-badge&logo=ai&logoColor=white) | ![Flow-state UX](https://img.shields.io/badge/Flow--state%20UX-32383e?style=for-the-badge&logo=flow&logoColor=white) | ![Privacy First](https://img.shields.io/badge/Privacy%20First-32383e?style=for-the-badge&logo=privacy&logoColor=white) | ![Advanced Tools](https://img.shields.io/badge/Fun%20To%20Use-f22a85?style=for-the-badge&logo=tools&logoColor=white) |  
-|---------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------| 
-| **Chat**<br/>**Call**<br/>**Beam**<br/>**Draw**, ...                                                          | Local & Cloud<br/>Open & Closed<br/>Cheap & Heavy<br/>Google, Mistral, ...                                              | Attachments<br/>Diagrams<br/>Multi-Chat<br/>Mobile-first UI                                                          | Stored Locally<br/>Easy self-Host<br/>Local actions<br/>Data = Gold                                                    | AI Personas<br/>Voice Modes<br/>Screen Capture<br/>Camera + OCR                                                      |
-
-![big-AGI screenshot](docs/pixels/big-AGI-compo-20240201_small.png)
-
-### AI Models & Vendors
-
-Configure 100s of AI models from 20+ providers:
-
-| **AI models**       | _supported vendors_                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-|:--------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| Opensource Servers  | [LocalAI](https://localai.io/) · [Ollama](https://ollama.com/)                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| Local Servers       | [LM Studio](https://lmstudio.ai/) (non-open)                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| Multimodal services | [Anthropic](https://anthropic.com) · [AWS Bedrock](https://aws.amazon.com/bedrock/) · [Azure](https://azure.microsoft.com/en-us/products/ai-services/openai-service) · [Google Gemini](https://ai.google.dev/) · [OpenAI](https://platform.openai.com/docs/overview)                                                                                                                                                                                                                       |
-| LLM services        | [Alibaba](https://www.alibabacloud.com/en/product/modelstudio) · [DeepSeek](https://deepseek.com) · [Groq](https://wow.groq.com/) · [Mistral](https://mistral.ai/) · [Moonshot](https://www.moonshot.cn/) · [OpenPipe](https://openpipe.ai/) · [OpenRouter](https://openrouter.ai/) · [Perplexity](https://www.perplexity.ai/) · [Together AI](https://www.together.ai/) · [xAI](https://x.ai/) · [Z.ai](https://z.ai/) |
-| OpenAI-compatible   | Any OpenAI-compatible endpoint - models, pricing, and capabilities are auto-detected                                                                                                                                                                                                                                                                                                                                                                                                         |
-| Image services      | OpenAI · Google Gemini (Nano Banana) · LocalAI                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| Speech services     | [ElevenLabs](https://elevenlabs.io) · [Inworld](https://inworld.ai) · [OpenAI TTS](https://platform.openai.com/docs/guides/text-to-speech) · LocalAI · Browser (Web Speech API)                                                                                                                                                                                                                                                                                                            |
-
-### Additional Integrations
-
-| **More**      | _integrations_                                                                                                 |
-|:--------------|:---------------------------------------------------------------------------------------------------------------| 
-| Web Browse    | [Browserless](https://www.browserless.io/) · [Puppeteer](https://pptr.dev/)-based                              |
-| Web Search    | [Google CSE](https://programmablesearchengine.google.com/)                                                     |
-| Observability | [Helicone](https://www.helicone.ai)                                                                            |
-
----
-
-## 🚀 Installation
-
-Self-host with Docker, deploy on Vercel, or develop locally. Full setup guide:
-
-[![Installation Guide](https://img.shields.io/badge/Installation%20Guide-blue?style=for-the-badge&logo=read-the-docs&logoColor=white)](docs/installation.md)
-
-Or use the hosted version at [big-agi.com](https://big-agi.com) with your API keys.
-
----
-
-## 👋 Community & Contributing
-
-### Connect
+## Support 🙌
 
+[//]: # ([![Official Discord]&#40;https://img.shields.io/discord/1098796266906980422?label=discord&logo=discord&logoColor=%23fff&style=for-the-badge&#41;]&#40;https://discord.gg/MkH4qj2Jp9&#41;)
 [![Official Discord](https://discordapp.com/api/guilds/1098796266906980422/widget.png?style=banner2)](https://discord.gg/MkH4qj2Jp9)
 
-⭐ [Star the repo](https://github.com/enricoros/big-agi) if Big-AGI is useful to you
+* Enjoy the hosted open-source app on [big-AGI.com](https://get.big-agi.com)
+* [Chat with us](https://discord.gg/MkH4qj2Jp9). We just started!
+* Deploy your [fork](https://github.com/enricoros/big-agi/fork) and surprise your friends with big-GPT
+  energy!
+* send PRs! ...
+  🎭[Editing Personas](https://github.com/enricoros/big-agi/issues/35),
+  🧩[Reasoning Systems](https://github.com/enricoros/big-agi/issues/36),
+  🌐[Community Templates](https://github.com/enricoros/big-agi/issues/35),
+  and [your big-IDEAs](https://github.com/enricoros/big-agi/issues/new?labels=RFC&body=Describe+the+idea)
 
-### Contribute
+<br/>
 
-**🤖 AI-Powered Issue Assistance**
+## Latest Drops 🚀
 
-When you open an issue, our custom AI triage system (powered by [Claude Code](https://github.com/anthropics/claude-code-action) with Big-AGI architecture documentation) analyzes it, searches the codebase, and provides solutions - typically within 30 minutes. We've trained the system on our modules and subsystems so it handles most issues effectively. Your feedback drives development!
+#### 🚨 May: mature #big-agi-energy 
 
-[![Open an Issue](https://img.shields.io/badge/Open_Issue-AI_Will_Help-ff8c00?style=for-the-badge&logo=fireship&logoColor=fff&labelColor=8b0000)](https://github.com/enricoros/big-agi/issues/new?template=ai-triage.yml)
-[![Request Feature](https://img.shields.io/badge/Request_Feature-Roadmap_Idea-orange?style=for-the-badge&logo=lightbulb&logoColor=white)](https://github.com/enricoros/big-agi/issues/new?&template=roadmap-request.md)
+- 🎉 **Authentication** basic user authentication framework
 
-[![Good First Issues](https://img.shields.io/badge/Good_First_Issues-Start-blue?style=for-the-badge&logo=github&logoColor=white)](https://github.com/users/enricoros/projects/4/views/4)
-[![Customization](https://img.shields.io/badge/Fork_&_Customize-Your_Own-purple?style=for-the-badge&logo=git&logoColor=white)](docs/customizations.md)
-[![Roadmap](https://img.shields.io/badge/Open_Roadmap-View-0366d6?style=for-the-badge&logo=github&logoColor=white)](https://github.com/users/enricoros/projects/4/views/2)
+#### April: #big-agi-energy grows
 
-#### Contributors
+- 🎉 **[Google Search](docs/pixels/feature_react_google.png)** active in ReAct - add your keys to Settings > Google Search
+- 🎉 **[Reason+Act](docs/pixels/feature_react_turn_on.png)** preview feature - activate with 2-taps on the 'Chat' button
+- 🎉 **[Image Generation](docs/pixels/feature_imagine_command.png)** using Prodia (BYO Keys) - /imagine - or menu option
+- 🎉 **[Voice Synthesis](docs/pixels/feature_voice_1.png)** 📣 with ElevenLabs, including selection of custom voices
+- 🎉 **[Precise Token Counter](docs/pixels/feature_token_counter.png)** 📈 extra-useful to pack the context window
+- 🎉 **[Install Mobile APP](docs/pixels/feature_pwa.png)** 📲 looks like native (@harlanlewis)
+- 🎉 **[UI language](docs/pixels/feature_language.png)** with auto-detect, and future app language! (@tbodyston)
+- 🎉 **PDF Summarization** 🧩🤯 - ask questions to a PDF! (@fredliubojin)
+- 🎉 **Code Execution: [Codepen](https://codepen.io/)/[Replit](https://replit.com/)** 💻 (@harlanlewis)
+- 🎉 **[SVG Drawing](docs/pixels/feature_svg_drawing.png)** - draw with AI 🎨
+- 🎉 Chats: multiple chats, AI titles, Import/Export, Selection mode
+- 🎉 Rendering: Markdown, SVG, improved Code blocks
+- 🎉 Integrations: OpenAI organization ID
+- 🎉 [Cloudflare deployment instructions](docs/deploy-cloudflare.md),
+  [awesome-agi](https://github.com/enricoros/awesome-agi)
+- 🎉 [Typing Avatars](docs/pixels/gif_typing_040123.gif) ⌨️
+  <!-- p><a href="docs/pixels/gif_typing_040123.gif"><img src="docs/pixels/gif_typing_040123.gif" width='700' alt="New Typing Avatars"/></a></p -->
 
-<a href="https://github.com/enricoros/big-agi/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=enricoros/big-agi&max=48&columns=12" />
-</a>
+#### March: first release
 
----
+- 🎉 **[AI Personas](docs/pixels/feature_purpose_two.png)** - including Code, Science, Corporate, and Chat 🎭
+- 🎉 **Privacy**: user-owned API keys 🔑 and localStorage 🛡️
+- 🎉 **Context** - Attach or [Drag & Drop files](docs/pixels/feature_drop_target.png) to add them to the prompt 📁
+- 🎉 **Syntax highlighting** - for multiple languages 🌈
+- 🎉 **Code Execution: Sandpack
+  ** - [now on branch]((https://github.com/enricoros/big-agi/commit/f678a0d463d5e9cf0733f577e11bd612b7902d89)) `variant-code-execution`
+- 🎉 Chat with GPT-4 and 3.5 Turbo 🧠💨
+- 🎉 Real-time streaming of AI responses ⚡
+- 🎉 **Voice Input** 🎙️ - works great on Chrome / Windows
+- 🎉 Integration: **[Paste.gg](docs/pixels/feature_paste_gg.png)** integration for chat sharing 📥
+- 🎉 Integration: **[Helicone](https://www.helicone.ai/)** integration for API observability 📊
+- 🌙 Dark model - Wide mode ⛶
 
-## License
+<br/>
 
-MIT License · [Third-Party Notices](src/modules/3rdparty/THIRD_PARTY_NOTICES.md)
+### Basic Authentication for public deployments 🔐
 
-**2023-2026** · [Enrico Ros](https://www.enricoros.com) × [Token Fabrics](https://www.tokenfabrics.com)
+To protect the web app owner from incurring unauthorized costs when deploying the app with a backend API key (`OPENAI_API_KEY`), you can [set up basic authentication.](/docs/authentication.md).
+
+## Why this? 💡
+
+Because the official Chat ___lacks important features___, is ___more limited than the api___, at times
+___slow or unavailable___, and you cannot deploy it yourself, remix it, add features, or share it with
+your friends.
+Our users report that ___big-AGI is faster___, ___more reliable___, and ___features rich___
+with features that matter to them.
+
+![Much features, so fun](docs/pixels/big-AGI-compo2b.png)
+
+## Code 🧩
+
+![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=&logo=typescript&logoColor=white)
+![React](https://img.shields.io/badge/React-61DAFB?style=&logo=react&logoColor=black)
+![Next.js](https://img.shields.io/badge/Next.js-000000?style=&logo=vercel&logoColor=white)
+
+Clone this repo, install the dependencies, and run the development server:
+
+```bash
+git clone https://github.com/enricoros/big-agi.git
+cd big-agi
+npm install
+npm run dev
+```
+
+Now the app should be running on `http://localhost:3000`
+
+### Integrations:
+
+* [ElevenLabs](https://elevenlabs.io/) Voice Synthesis (bring your own voice too) - Settings > Text To Speech
+* [Helicone](https://www.helicone.ai/) LLM Observability Platform - Settings > Advanced > API Host: 'oai.hconeai.com'
+* [Paste.gg](https://paste.gg/) Paste Sharing - Chat Menu > Share via paste.gg
+* [Prodia](https://prodia.com/) Image Generation - Settings > Image Generation > Api Key & Model
+
+<br/>
+
+This project is licensed under the MIT License.
+
+[![GitHub stars](https://img.shields.io/github/stars/enricoros/big-agi)](https://github.com/enricoros/big-agi/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/enricoros/big-agi)](https://github.com/enricoros/big-agi/network)
+[![GitHub pull requests](https://img.shields.io/github/issues-pr/enricoros/big-agi)](https://github.com/enricoros/big-agi/pulls)
+[![License](https://img.shields.io/github/license/enricoros/big-agi)](https://github.com/enricoros/big-agi/LICENSE)
+
+[//]: # ([![GitHub issues]&#40;https://img.shields.io/github/issues/enricoros/big-agi&#41;]&#40;https://github.com/enricoros/big-agi/issues&#41;)
+
+Made with 💙

app/api/cloud/[trpc]/route.ts

@@ -1,39 +0,0 @@
-import { fetchRequestHandler } from '@trpc/server/adapters/fetch';
-
-import { appRouterCloud } from '~/server/trpc/trpc.router-cloud';
-import { createTRPCFetchContext } from '~/server/trpc/trpc.server';
-import { posthogServerSendException } from '~/server/posthog/posthog.server';
-
-const handlerNodeRoutes = (req: Request) => fetchRequestHandler({
-  endpoint: '/api/cloud',
-  router: appRouterCloud,
-  req,
-  createContext: createTRPCFetchContext,
-  onError: async function({ path, error, type, ctx }) {
-
-    // -> DEV error logging
-    if (process.env.NODE_ENV === 'development')
-      console.error(`❌ tRPC-cloud failed on ${path ?? 'unk-path'}: ${error.message}`);
-
-    // -> Capture node errors
-    await posthogServerSendException(error, undefined, {
-      domain: 'trpc-onerror',
-      runtime: 'nodejs',
-      endpoint: path ?? 'unknown',
-      method: req.method,
-      url: req.url,
-      additionalProperties: {
-        error_code: error.code,
-        error_type: type,
-      },
-    });
-  },
-});
-
-
-// NOTE: the following statement breaks the build on non-pro deployments, and conditionals don't work either
-//       so we resorted to raising the timeout from 10s to 60s in the vercel.json file instead
-// export const maxDuration = 60;
-export const runtime = 'nodejs';
-export const dynamic = 'force-dynamic';
-export { handlerNodeRoutes as GET, handlerNodeRoutes as POST };

app/api/edge/[trpc]/route.ts

@@ -1,20 +0,0 @@
-import { fetchRequestHandler } from '@trpc/server/adapters/fetch';
-
-import { appRouterEdge } from '~/server/trpc/trpc.router-edge';
-import { createTRPCFetchContext } from '~/server/trpc/trpc.server';
-
-const handlerEdgeRoutes = (req: Request) => fetchRequestHandler({
-  endpoint: '/api/edge',
-  router: appRouterEdge,
-  req,
-  createContext: createTRPCFetchContext,
-  onError:
-    process.env.NODE_ENV === 'development'
-      ? ({ path, error }) => console.error(`\n❌ tRPC-edge failed on ${path ?? 'unk-path'}: ${error.message}`)
-      : undefined,
-});
-
-// NOTE: we don't set maxDuration explicitly here - however we set it in the Vercel project settings, raising to the limit of 300s
-// export const maxDuration = 60;
-export const runtime = 'edge';
-export { handlerEdgeRoutes as GET, handlerEdgeRoutes as POST };

docker-compose.yaml

@@ -1,11 +0,0 @@
-# Very simple docker-compose file to run the app on http://localhost:3000 (or http://127.0.0.1:3000).
-#
-# For more examples, such running big-AGI alongside a web browsing service, see the `docs/docker` folder.
-
-services:
-  big-agi:
-    image: ghcr.io/enricoros/big-agi:latest
-    ports:
-      - "3000:3000"
-    env_file:
-      - .env

docs/2024-AI-APIs-Comparison.md

@@ -1,74 +0,0 @@
----
-unlisted: true
----
-
-# AIX dispatch server - API features comparison
-
-This is updated as of 2024-07-09, and includes the latest features and capabilities of the three major AI APIs: Anthropic, Gemini, and OpenAI.
-The comparison covers a wide range of features, including function calling, vision, system instructions, etc.
-
-| Feature Category                         | Specific Feature              | Anthropic                                                          | Gemini                                                           | OpenAI                                                              |
-|------------------------------------------|-------------------------------|--------------------------------------------------------------------|------------------------------------------------------------------|---------------------------------------------------------------------|
-| **Message Structure**                    |
-|                                          | Role types                    | user, assistant                                                    | user, model                                                      | user, assistant, system, tool                                       |
-|                                          | Named participants            | No                                                                 | No                                                               | Yes                                                                 |
-|                                          | Content array                 | Yes                                                                | Yes                                                              | Yes                                                                 |
-| **Content Types and Multimodal Support** |
-|                                          | Text generation               | Yes                                                                | Yes                                                              | Yes                                                                 |
-|                                          | Image understanding           | Yes                                                                | Yes                                                              | Yes                                                                 |
-|                                          | Audio processing              | No                                                                 | **Yes**                                                          | No                                                                  |
-|                                          | Video processing              | No                                                                 | **Yes**                                                          | No                                                                  |
-| **Image Handling**                       |
-|                                          | Supported formats             | JPEG, PNG, GIF, WebP                                               | JPEG, PNG, WebP, HEIC, HEIF                                      | PNG, JPEG, WebP, non-animated GIF                                   |
-|                                          | Max image size                | 5MB per image                                                      | (20MB per prompt)                                                | 20MB per image                                                      |
-|                                          | Image detail level            | N/A                                                                | N/A                                                              | **Low, high, auto**                                                 |
-|                                          | Image resolution              | max: 1568x1568                                                     | min: 768x768, max: 3072x3072                                     | min: 512x512, max: 2048 x 2048                                      |
-|                                          | Token calculation for images  | (width * height)/750; max 1,600                                    | 258 tokens                                                       | 85 + 170 * {patches}                                                |
-|                                          | Image retention               | Deleted after processing                                           | Not specified                                                    | Deleted after processing                                            |
-| **Audio and Video Handling**             |
-|                                          | Audio formats                 | N/A                                                                | WAV, MP3, AIFF, AAC, OGG, FLAC                                   | N/A                                                                 |
-|                                          | Video formats                 | N/A                                                                | MP4, MPEG, MOV, AVI, MPG, WebM, WMV, 3GPP                        | N/A                                                                 |
-| **System Instructions and Tool Use**     |
-|                                          | System instructions           | Yes (array of text blocks)                                         | Yes (parts array)                                                | Yes (as system message)                                             |
-| **Function/Tool Handling**               |
-|                                          | Parallel tool calls           | No                                                                 | No                                                               | **Yes**                                                             |
-|                                          | Tool Declaration              | Defined in `tools` array                                           | Defined in `tools` array                                         | Defined in `tools` array                                            |
-|                                          | FC name restrictions          | Yes                                                                | Yes (max 63 chars)                                               | Yes (max 64 chars)                                                  |
-|                                          | FC declaration                | name, description, input_schema                                    | name, description, parameters                                    | name, description, parameters                                       |
-|                                          | FC options structure          | JSON Schema for input                                              | Object with properties                                           | JSON Schema for parameters                                          |
-|                                          | FC Force invocation           | Via `tool_choice` parameter                                        | Via `toolConfig` parameter                                       | Via `tool_choice` parameter                                         |
-|                                          | FC Model invocation           | Model generates a `tool_use` block with predicted parameters       | Generates a `functionCall` part with predicted parameters        | Generates a message.`tool_calls` item with predicted arguments      |
-|                                          | FC Execution                  | Client-side                                                        | Client-side                                                      | Client-side                                                         |
-|                                          | FC Result injection           | Client appends a `user` message with a `tool_result` content block | Client appends a `function` message with `functionResponse` part | Client sends a new `tool` message with `tool_call_id` and `content` |
-|                                          | Built-in Code execution       | No                                                                 | **Yes**                                                          | No                                                                  |
-|                                          | Tool use with vision          | Yes                                                                | Yes                                                              | Yes                                                                 |
-| **Generation Configuration**             |
-|                                          | temperature                   | Yes                                                                | Yes                                                              | Yes                                                                 |
-|                                          | max_tokens                    | Yes                                                                | Yes                                                              | Yes                                                                 |
-|                                          | stop_sequences                | Yes                                                                | Yes                                                              | Yes                                                                 |
-|                                          | top_k                         | Yes                                                                | Yes                                                              | **No**                                                              |
-|                                          | top_p                         | Yes                                                                | Yes                                                              | Yes                                                                 |
-|                                          | seed                          | No                                                                 | No                                                               | **Yes**                                                             |
-|                                          | Multiple candidates           | No                                                                 | No                                                               | Yes (with 'n' parameter, breaks streaming?)                         |
-| **Streaming and Response Structure**     |
-|                                          | Streaming support             | Yes                                                                | Yes                                                              | Yes                                                                 |
-|                                          | Streaming initiation          | stream=true                                                        | streamGenerateContent path                                       | stream=true                                                         |
-|                                          | Streaming event types         | **Multiple specific types**                                        | Not specified                                                    | Single delta type                                                   |
-|                                          | Response container            | content (array)                                                    | candidates (array)                                               | choices (array)                                                     |
-| **Usage Metrics and Error Handling**     |
-|                                          | Token counts                  | Yes                                                                | Yes                                                              | Yes                                                                 |
-|                                          | Detailed token breakdown      | input, output                                                      | prompt, cached, candidates, total                                | prompt, completion, total                                           |
-|                                          | Usage in stream               | No                                                                 | No                                                               | **Optional**                                                        |
-|                                          | Error handling in response    | Not specified                                                      | Not specified                                                    | **Yes (undocumented)**                                              |
-|                                          | Error handling in stream      | Not specified                                                      | Not specified                                                    | **Yes (undocumented)**                                              |
-| **Advanced Features**                    |
-|                                          | JSON mode                     | **Partial (via structured prompts)**                               | **Yes (responseMimeType)**                                       | **Yes**                                                             |
-|                                          | Output consistency techniques | **Yes (multiple methods)**                                         | Not specified                                                    | Not specified                                                       |
-|                                          | Logprobs                      | No                                                                 | No                                                               | **Yes (disabled in schema)**                                        |
-|                                          | System fingerprint            | No                                                                 | No                                                               | **Yes**                                                             |
-|                                          | Semantic caching              | No                                                                 | **Yes**                                                          | No                                                                  |
-|                                          | Assistant prefill             | **Yes**                                                            | No                                                               | No                                                                  |
-|                                          | Preferred formatting          | **XML tags, JSON**                                                 | Not specified                                                    | Markdown                                                            |
-| **Safety and Compliance**                |
-|                                          | Safety settings in request    | **Stop sequences**                                                 | **Detailed category-based**                                      | **Moderation API**                                                  |
-|                                          | Safety feedback in response   | Yes                                                                | Yes                                                              | Not specified                                                       |

docs/README.md

@@ -1,81 +0,0 @@
-# Big-AGI Documentation
-
-Information you need to get started, configure, and use big-AGI productively.
-
-👉 **[Changelog](https://big-agi.com/changes)** - See what's new
-
-## Getting Started
-
-Essential guides:
-
-- **[FAQ](help-faq.md)**: Common questions and answers
-- **[Enabling Microphone](help-feature-microphone.md)**: Configure speech recognition in your browser
-- **[Data Ownership](help-data-ownership.md)**: How your data is stored and managed
-- **[Live File](help-feature-livefile.md)**: Live file attachment feature
-
-## AI Services
-
-How to set up AI models and features in big-AGI.
-
-> 👉 The following applies to users of big-AGI.com, as the public instance is empty and requires user configuration.
-
-- **Cloud AI Services**:
-  - Easy API key configuration:
-    [Alibaba](https://bailian.console.alibabacloud.com/?apiKey=1#/api-key),
-    [Anthropic](https://console.anthropic.com/settings/keys),
-    [AWS Bedrock](https://console.aws.amazon.com/bedrock/),
-    [Deepseek](https://platform.deepseek.com/api_keys),
-    [Google Gemini](https://aistudio.google.com/app/apikey),
-    [Groq](https://console.groq.com/keys),
-    [Mistral](https://console.mistral.ai/api-keys/),
-    [Moonshot](https://platform.moonshot.cn/console/api-keys),
-    [OpenAI](https://platform.openai.com/api-keys),
-    [OpenPipe](https://app.openpipe.ai/settings),
-    [Perplexity](https://www.perplexity.ai/settings/api),
-    [TogetherAI](https://api.together.xyz/settings/api-keys),
-    [xAI](https://x.ai/api),
-    [Z.ai](https://z.ai/)
-  - **[Azure OpenAI](config-azure-openai.md)** guide
-  - **[OpenRouter](config-openrouter.md)** guide
-  - **OpenAI-compatible endpoints**: Any provider with an OpenAI-compatible API works out of the box - models, pricing, and capabilities are auto-detected
-
-
-- **Local AI Integrations**:
-  - [LocalAI](config-local-localai.md), [LM Studio](config-local-lmstudio.md), [Ollama](config-local-ollama.md)
-
-
-- **Enhanced AI Features**:
-  - **[Web Browsing](config-feature-browse.md)**: Enable web page download through third-party services or your own cloud
-  - **Web Search**: Google Search API (see '[Environment Variables](environment-variables.md)')
-  - **Image Generation**: GPT Image (gpt-image-1), Nano Banana, DALL·E 3 and 2
-  - **Voice Synthesis**: ElevenLabs, Inworld, OpenAI TTS, LocalAI, or browser Web Speech API
-  - **[Google Drive](config-feature-google-drive.md)**: Attach files from Google Drive
-
-## Deployment & Customization
-
-> 👉 The following applies to developers and experts who deploy their own big-AGI instance.
-
-For deploying a custom big-AGI instance:
-
-- **[Installation Guide](installation.md)**, including:
-  - Set up your own big-AGI instance
-  - Source build or pre-built options
-  - Local, cloud, or on-premises deployment
-
-
-- **Advanced Setup**:
-  - **[Source Code Customization](customizations.md)**: Modify the source code
-  - **[Access Control](deploy-authentication.md)**: Optional, add basic user authentication
-  - **[Reverse Proxy](deploy-reverse-proxy.md)**: Optional, enables custom domains and SSL
-  - **[Docker Deployment](deploy-docker.md)**: Deploy with Docker containers
-  - **[Kubernetes](deploy-k8s.md)**: Deploy on Kubernetes clusters
-  - **[Analytics](deploy-analytics.md)**: Set up usage analytics
-  - **[Environment Variables](environment-variables.md)**: Pre-configures models and services
-
-## Community & Support
-
-- Check the [changelog](https://big-agi.com/changes) for the latest updates
-- Visit our [GitHub repository](https://github.com/enricoros/big-AGI) for source code and issue tracking
-- Join our [Discord](https://discord.gg/MkH4qj2Jp9) for discussions and help
-
-Let's build something great.

docs/authentication.md

@@ -0,0 +1,37 @@
+### Authentication with NextAuth.js 🔐
+
+To protect the web app owner from incurring unauthorized costs when deploying the app with a backend API
+key (`OPENAI_API_KEY`), you can set up basic authentication using [NextAuth.js](https://next-auth.js.org/).
+
+#### Configuration
+
+Update your `.env` file or Environment Variables with the following variables:
+
+```
+# [Optional] Set the authentication type to "credential" to enable basic username/password authentication
+AUTH_TYPE=credential
+
+# [Required if AUTH_TYPE == credential] Define credentials for users - you can declare up to 100 users
+AUTH_USER_0=your_username
+AUTH_PASSWORD_0=your_password
+AUTH_USER_1=...
+AUTH_PASSWORD_1=...
+...
+
+# [Required if AUTH_TYPE == credential and *not in development mode*] See: https://next-auth.js.org/configuration/options#nextauth_url
+NEXTAUTH_URL=https://example.com
+
+# [Required if AUTH_TYPE == credential] See: https://next-auth.js.org/configuration/options#secret
+NEXTAUTH_SECRET=your_nextauth_secret
+```
+
+You can add multiple users by incrementing the index, e.g., `AUTH_USER_1`, `AUTH_PASSWORD_1`, and so on. They do not
+need to be contiguous.
+
+#### Usage
+
+Once you have set up basic authentication, users will be prompted to enter their credentials when accessing the app.
+Only users with valid credentials will be able to use the app and make requests to the OpenAI API.
+
+For more information on configuring and using NextAuth.js, refer to
+the [official documentation](https://next-auth.js.org/).

docs/changelog.md

@@ -1,256 +0,0 @@
-## Archived Versions - Changelog
-
-This is a high-level changelog. Calls out some of the high level features batched
-by release.
-
-- For the live changelog, see [big-agi.com/changes](https://big-agi.com/changes)
-- For the live roadmap, please see [the GitHub project](https://github.com/users/enricoros/projects/4/views/2)
-
-> NOTE: with the release of 2.0.0 we switching to [big-agi.com/changes](https://big-agi.com/changes) for the
-> continuously updated changelog.
-
-### What's New in 2 · Oct 31, 2025 · Open
-
-- **Big-AGI Open** is ready and more productive and faster than ever, with:
-- **Beam 2**: multi-modal, program-based, follow-ups, save presets
-- Top-notch AI models support including **agentic models** and **reasoning models**
-- **Image Generation** and editing with Nano Banana and gpt-image-1
-- **Web Search** with citations for supported models
-- **UI** & Mobile UI overhaul with peeking and side panels
-- And all of the [Big-AGI 2 changes](https://github.com/enricoros/big-AGI/issues/567#issuecomment-2262187617) and more
-- Built for the future, madly optimized
-
-### What's New in 1.16.1...1.16.13 · (patch releases)
-
-- 1.16.13: Docker fix (#840)
-- 1.16.12: Dockerfile update (#840)
-- 1.16.11: v1 final release, documentation updates
-- 1.16.10: OpenRouter models support
-- 1.16.9: Docker Gemini fix, R1 models support
-- 1.16.8: OpenAI ChatGPT-4o Latest, o1 models support
-- 1.16.7: OpenAI support for GPT-4o 2024-08-06
-- 1.16.6: Groq support for Llama 3.1 models
-- 1.16.5: GPT-4o Mini support
-- 1.16.4: 8192 tokens support for Claude 3.5 Sonnet
-- 1.16.3: Anthropic Claude 3.5 Sonnet model support
-- 1.16.2: Improve web downloads, as text, markdown, or HTML
-- 1.16.2: Proper support for Gemini models
-- 1.16.2: Added the latest Mistral model
-- 1.16.2: Tokenizer support for gpt-4o
-- 1.16.2: Updates to Beam
-- 1.16.1: Support for the new OpenAI GPT-4o 2024-05-13 model
-
-### What's New in 1.16.0 · May 9, 2024 · Crystal Clear
-
-- [Beam](https://big-agi.com/blog/beam-multi-model-ai-reasoning) core and UX improvements based on user feedback
-- Chat cost estimation 💰 (enable it in Labs / hover the token counter)
-- Save/load chat files with Ctrl+S / Ctrl+O on desktop
-- Major enhancements to the Auto-Diagrams tool
-- YouTube Transcriber Persona for chatting with video content, [#500](https://github.com/enricoros/big-AGI/pull/500)
-- Improved formula rendering (LaTeX), and dark-mode diagrams, [#508](https://github.com/enricoros/big-AGI/issues/508), [#520](https://github.com/enricoros/big-AGI/issues/520)
-- Models update: **Anthropic**, **Groq**, **Ollama**, **OpenAI**, **OpenRouter**, **Perplexity**
-- Code soft-wrap, chat text selection toolbar, 3x faster on Apple silicon, and more [#517](https://github.com/enricoros/big-AGI/issues/517), [507](https://github.com/enricoros/big-AGI/pull/507)
-- Developers: update the LLMs data structures
-
-### What's New in 1.15.1 · April 10, 2024 (minor release, models support)
-
-- Support for the newly released Gemini Pro 1.5 models
-- Support for the new OpenAI 2024-04-09 Turbo models
-- Resilience fixes after the large success of 1.15.0
-
-### What's New in 1.15.0 · April 1, 2024 · Beam
-
-- ⚠️ [**Beam**: the multi-model AI chat](https://big-agi.com/blog/beam-multi-model-ai-reasoning). find better answers, faster - a game-changer for brainstorming, decision-making, and creativity. [#443](https://github.com/enricoros/big-AGI/issues/443)
-- Managed Deployments **Auto-Configuration**: simplify the UI models setup with backend-set models. [#436](https://github.com/enricoros/big-AGI/issues/436)
-- Message **Starring ⭐**: star important messages within chats, to attach them later. [#476](https://github.com/enricoros/big-AGI/issues/476)
-- Enhanced the default Persona
-- Fixes to Gemini models and SVGs, improvements to UI and icons
-- Beast release, over 430 commits, 10,000+ lines changed: [release notes](https://github.com/enricoros/big-AGI/releases/tag/v1.15.0), and changes [v1.14.1...v1.15.0](https://github.com/enricoros/big-AGI/compare/v1.14.1...v1.15.0)
-
-### What's New in 1.14.1 · March 7, 2024 · Modelmorphic
-
-- **Anthropic** [Claude-3](https://www.anthropic.com/news/claude-3-family) model family support. [#443](https://github.com/enricoros/big-AGI/issues/443)
-- New **[Perplexity](https://www.perplexity.ai/)** and **[Groq](https://groq.com/)** integration (thanks @Penagwin). [#407](https://github.com/enricoros/big-AGI/issues/407), [#427](https://github.com/enricoros/big-AGI/issues/427)
-- **[LocalAI](https://localai.io/models/)** deep integration, including support for [model galleries](https://github.com/enricoros/big-AGI/issues/411)
-- **Mistral** Large and Google **Gemini 1.5** support
-- Performance optimizations: runs [much faster](https://x.com/enricoros/status/1756553038293303434?utm_source=localhost:3000&utm_medium=big-agi), saves lots of power, reduces memory usage
-- Enhanced UX with auto-sizing charts, refined search and folder functionalities, perfected scaling
-- And with more UI improvements, documentation, bug fixes (20 tickets), and developer enhancements
-- [Release notes](https://github.com/enricoros/big-AGI/releases/tag/v1.14.0), and changes [v1.13.1...v1.14.0](https://github.com/enricoros/big-AGI/compare/v1.13.1...v1.14.0) (233 commits, 8,000+ lines changed)
-
-### What's New in 1.13.0 · Feb 8, 2024 · Multi + Mind
-
-https://github.com/enricoros/big-AGI/assets/32999/01732528-730e-41dc-adc7-511385686b13
-
-- **Side-by-Side Split Windows**: multitask with parallel conversations. [#208](https://github.com/enricoros/big-AGI/issues/208)
-- **Multi-Chat Mode**: message everyone, all at once. [#388](https://github.com/enricoros/big-AGI/issues/388)
-- **Export tables as CSV**: big thanks to @aj47. [#392](https://github.com/enricoros/big-AGI/pull/392)
-- Adjustable text size: customize density. [#399](https://github.com/enricoros/big-AGI/issues/399)
-- Dev2 Persona Technology Preview
-- Better looking chats with improved spacing, fonts, and menus
-- More: new video player, [LM Studio tutorial](https://github.com/enricoros/big-AGI/blob/main/docs/config-local-lmstudio.md) (thanks @aj47), [MongoDB support](https://github.com/enricoros/big-AGI/blob/main/docs/deploy-database.md) (thanks @ranfysvalle02), and speedups
-
-### What's New in 1.12.0 · Jan 26, 2024 · AGI Hotline
-
-https://github.com/enricoros/big-AGI/assets/32999/95ceb03c-945d-4fdd-9a9f-3317beb54f3f
-
-- **Voice Calls**: real-time voice call your personas out of the blue or in relation to a chat [#354](https://github.com/enricoros/big-AGI/issues/354)
-- Support **OpenAI 0125** Models. [#364](https://github.com/enricoros/big-AGI/issues/364)
-- Rename or Auto-Rename chats.  [#222](https://github.com/enricoros/big-AGI/issues/222), [#360](https://github.com/enricoros/big-AGI/issues/360)
-- More control over **Link Sharing** [#356](https://github.com/enricoros/big-AGI/issues/356)
-- **Accessibility** to screen readers [#358](https://github.com/enricoros/big-AGI/issues/358)
-- Export chats to Markdown [#337](https://github.com/enricoros/big-AGI/issues/337)
-- Paste tables from Excel [#286](https://github.com/enricoros/big-AGI/issues/286)
-- Ollama model updates and context window detection fixes [#309](https://github.com/enricoros/big-AGI/issues/309)
-
-### What's New in 1.11.0 · Jan 16, 2024 · Singularity
-
-https://github.com/enricoros/big-AGI/assets/1590910/a6b8e172-0726-4b03-a5e5-10cfcb110c68
-
-- **Find chats**: search in titles and content, with frequency ranking. [#329](https://github.com/enricoros/big-AGI/issues/329)
-- **Commands**: command auto-completion (type '/'). [#327](https://github.com/enricoros/big-AGI/issues/327)
-- **[Together AI](https://www.together.ai/products#inference)** inference platform support (good speed and newer models). [#346](https://github.com/enricoros/big-AGI/issues/346)
-- Persona Creator history, deletion, custom creation, fix llm API timeouts
-- Enable adding up to five custom OpenAI-compatible endpoints
-- Developer enhancements: new 'Actiles' framework
-
-### What's New in 1.10.0 · Jan 6, 2024 · The Year of AGI
-
-- **New UI**: for both desktop and mobile, sets the stage for future scale. [#201](https://github.com/enricoros/big-AGI/issues/201)
-- **Conversation Folders**: enhanced conversation organization. [#321](https://github.com/enricoros/big-AGI/issues/321)
-- **[LM Studio](https://lmstudio.ai/)** support and improved token management
-- Resizable panes in split-screen conversations.
-- Large performance optimizations
-- Developer enhancements: new UI framework, updated documentation for proxy settings on browserless/docker
-
-### What's New in 1.9.0 · Dec 28, 2023 · Creative Horizons
-
-- **DALL·E 3 integration** for enhanced image generation. [#212](https://github.com/enricoros/big-AGI/issues/212)
-- **Perfect scrolling mechanics** across devices. [#304](https://github.com/enricoros/big-AGI/issues/304)
-- Persona creation now supports **text input**. [#287](https://github.com/enricoros/big-AGI/pull/287)
-- Openrouter updates for better model management and rate limit handling
-- Image drawing UX improvements
-- Layout fix for Firefox users
-- Developer enhancements: Text2Image subsystem, Optima layout, ScrollToBottom library, Panes library, and Llms subsystem updates.
-
-### What's New in 1.8.0 · Dec 20, 2023 · To The Moon And Back
-
-- **Google Gemini Support**: Use the newest Google models. [#275](https://github.com/enricoros/big-agi/issues/275)
-- **Mistral Platform**: Mixtral and future models support. [#273](https://github.com/enricoros/big-agi/issues/273)
-- **Diagram Instructions**. Thanks to @joriskalz! [#280](https://github.com/enricoros/big-agi/pull/280)
-- Ollama Chats: Enhanced chatting experience. [#270](https://github.com/enricoros/big-agi/issues/270)
-- Mac Shortcuts Fix: Improved UX on Mac
-- **Single-Tab Mode**: Data integrity with single window. [#268](https://github.com/enricoros/big-agi/issues/268)
-- **Updated Models**: Latest Ollama (v0.1.17) and OpenRouter models
-- Official Downloads: Easy access to the latest big-AGI on [big-AGI.com](https://big-agi.com)
-- For developers: [troubleshot networking](https://github.com/enricoros/big-AGI/issues/276#issuecomment-1858591483), fixed Vercel deployment, cleaned up the LLMs/Streaming framework
-
-### What's New in 1.7.0 · Dec 11, 2023 · Attachment Theory
-
-- **Attachments System Overhaul**: Drag, paste, link, snap, text, images, PDFs and more. [#251](https://github.com/enricoros/big-agi/issues/251)
-- **Desktop Webcam Capture**: Image capture now available as Labs feature. [#253](https://github.com/enricoros/big-agi/issues/253)
-- **Independent Browsing**: Full browsing support with Browserless. [Learn More](https://github.com/enricoros/big-agi/blob/main/docs/config-feature-browse.md)
-- **Overheat LLMs**: Push the creativity with higher LLM temperatures. [#256](https://github.com/enricoros/big-agi/issues/256)
-- **Model Options Shortcut**: Quick adjust with `Ctrl+Shift+O`
-- Optimized Voice Input and Performance
-- Latest Ollama models
-- For developers: **Password Protection**: HTTP Basic Auth. [Learn How](https://github.com/enricoros/big-agi/blob/main/docs/deploy-authentication.md)
-
-### What's New in 1.6.0 - Nov 28, 2023 · Surf's Up
-
-- **Web Browsing**: Download web pages within chats - [browsing guide](https://github.com/enricoros/big-agi/blob/main/docs/config-feature-browse.md)
-- **Branching Discussions**: Create new conversations from any message
-- **Keyboard Navigation**: Swift chat navigation with new shortcuts (e.g. ctrl+alt+left/right)
-- **Performance Boost**: Faster rendering for a smoother experience
-- **UI Enhancements**: Refined interface based on user feedback
-- **New Features**: Anthropic Claude 2.1, `/help` command, and Flattener tool
-- **For Developers**: Code quality upgrades and snackbar notifications
-
-### What's New in 1.5.0 - Nov 19, 2023 · Loaded
-
-- **Continued Voice**: Engage with hands-free interaction for a seamless experience
-- **Visualization Tool**: Create data representations with our new visualization capabilities
-- **Ollama Local Models**: Leverage local models support with our comprehensive guide
-- **Text Tools**: Enjoy tools including highlight differences to refine your content
-- **Mermaid Diagramming**: Render complex diagrams with our Mermaid language support
-- **OpenAI 1106 Chat Models**: Experience the cutting-edge capabilities of the latest OpenAI models
-- **SDXL Support**: Enhance your image generation with SDXL support for Prodia
-- **Cloudflare OpenAI API Gateway**: Integrate with Cloudflare for a robust API gateway
-- **Helicone for Anthropic**: Utilize Helicone's tools for Anthropic models
-
-For Developers:
-
-- Runtime Server-Side configuration:  https://github.com/enricoros/big-agi/issues/189. Env vars are
-  not required to be set at build time anymore. The frontend will roundtrip to the backend at the
-  first request to get the configuration. See
-  https://github.com/enricoros/big-agi/blob/main/src/modules/backend/backend.router.ts.
-- CloudFlare developers: please change the deployment command to
-  `rm app/api/cloud/[trpc]/route.ts && npx @cloudflare/next-on-pages@1`,
-  as we transitioned to the App router in NextJS 14. The documentation in
-  [docs/deploy-cloudflare.md](../docs/deploy-cloudflare.md) is updated
-
-### 1.4.0: Sept/Oct: scale OUT
-
-- **Expanded Model Support**: Azure and [OpenRouter](https://openrouter.ai/docs#models) models, including gpt-4-32k
-- **Share and clone** conversations with public links
-- Removed the 20 chats hard limit ([Ashesh3](https://github.com/enricoros/big-agi/pull/158))
-- Latex Rendering
-- Augmented Chat modes (Labs)
-
-### July/Aug: More Better Faster
-
-- **Camera OCR** - real-world AI - take a picture of a text, and chat with it
-- **Anthropic models** support, e.g. Claude
-- **Backup/Restore** - save chats, and restore them later
-- **Flatten conversations** - conversations summarizer with 4 modes
-- **Fork conversations** - create a new chat, to try with different endings
-- New commands: /s to add a System message, and /a for an Assistant message
-- New Chat modes: Write-only - just appends the message, without assistant response
-- Fix STOP generation - in sync with the Vercel team to fix a long-standing NextJS issue
-- Fixes on the HTML block - particularly useful to see error pages
-
-### June: scale UP
-
-- **[New OpenAI Models](https://openai.com/blog/function-calling-and-other-api-updates) support** - 0613 models, including 16k and 32k
-- **Cleaner UI** - with rationalized Settings, Modals, and Configurators
-- **Dynamic Models Configurator** - easy connection with different model vendors
-- **Multiple Model Vendors Support** framework to support many LLM vendors
-- **Per-model Options** (temperature, tokens, etc.) for fine-tuning AI behavior to your needs
-- Support for GPT-4-32k
-- Improved Dialogs and Messages
-- Much Enhanced DX: TRPC integration, modularization, pluggable UI, etc
-
-### April / May: more #big-agi-energy
-
-- **[Google Search](../docs/pixels/feature_react_google.png)** active in ReAct - add your keys to Settings > Google
-  Search
-- **[Reason+Act](../docs/pixels/feature_react_turn_on.png)** preview feature - activate with 2-taps on the 'Chat' button
-- **[Image Generation](../docs/pixels/feature_imagine_command.png)** using Prodia (BYO Keys) - /imagine - or menu option
-- **[Voice Synthesis](../docs/pixels/feature_voice_1.png)** 📣 with ElevenLabs, including selection of custom voices
-- **[Precise Token Counter](../docs/pixels/feature_token_counter.png)** 📈 extra-useful to pack the context window
-- **[Install Mobile APP](../docs/pixels/feature_pwa.png)** 📲 looks like native (@harlanlewis)
-- **[UI language](../docs/pixels/feature_language.png)** with auto-detect, and future app language! (@tbodyston)
-- **PDF Summarization** 🧩🤯 - ask questions to a PDF! (@fredliubojin)
-- **[SVG Drawing](../docs/pixels/feature_svg_drawing.png)** - draw with AI 🎨
-- Chats: multiple chats, AI titles, Import/Export, Selection mode
-- Rendering: Markdown, SVG, improved Code blocks
-- Integrations: OpenAI organization ID
-- [Cloudflare deployment instructions](../docs/deploy-cloudflare.md),
-  [awesome-agi](https://github.com/enricoros/awesome-agi)
-- [Typing Avatars](../docs/pixels/gif_typing_040123.gif) ⌨️
-  <!-- p><a href="../docs/pixels/gif_typing_040123.gif"><img src="../docs/pixels/gif_typing_040123.gif" width='700' alt="New Typing Avatars"/></a></p -->
-
-### March: first release
-
-- **[AI Personas](../docs/pixels/feature_purpose_two.png)** - including Code, Science, Corporate, and Chat 🎭
-- **Privacy**: user-owned API keys 🔑 and localStorage 🛡️
-- **Context** - Attach or [Drag & Drop files](../docs/pixels/feature_drop_target.png) to add them to the prompt 📁
-- **Syntax highlighting** - for multiple languages 🌈
-- **Code Execution: Sandpack** -
-  [now on branch]((https://github.com/enricoros/big-agi/commit/f678a0d463d5e9cf0733f577e11bd612b7902d89)) `variant-code-execution`
-- Chat with GPT-4 and 3.5 Turbo 🧠💨
-- Real-time streaming of AI responses ⚡
-- **Voice Input** 🎙️ - works great on Chrome / Windows
-- Integration: **[Paste.gg](../docs/pixels/feature_paste_gg.png)** integration for chat sharing 📥
-- Integration: **[Helicone](https://www.helicone.ai/)** integration for API observability 📊
-- 🌙 Dark model - Wide mode ⛶

docs/config-azure-openai.md

@@ -1,110 +0,0 @@
-# Configuring Azure OpenAI Service with `big-AGI`
-
-The entire procedure takes about 5 minutes and involves creating an Azure account,
-setting up the Azure OpenAI service, deploying models, and configuring `big-AGI`
-to access these models.
-
-Please note that Azure operates on a 'pay-as-you-go' pricing model and requires
-credit card information tied to a 'subscription' to the Azure service.
-
-## Configuring `big-AGI`
-
-If you have an `API Endpoint` and `API Key`, you can configure big-AGI as follows:
-
-1. Launch the `big-AGI` application
-2. Go to the **Models** settings
-3. Add a Vendor and select **Azure OpenAI**
-    - Enter the Endpoint (e.g., 'https://your-resource-name.openai.azure.com')
-    - Enter the API Key (e.g., 'fd5...........................ba')
-
-The deployed models are now available in the application. If you don't have a configured
-Azure OpenAI service instance, continue with the next section.
-
-In addition to using the UI, configuration can also be done using
-[environment variables](environment-variables.md).
-
-## Server Configuration
-
-For server deployments, set these environment variables:
-
-```bash
-AZURE_OPENAI_API_ENDPOINT=https://your-resource-name.openai.azure.com
-AZURE_OPENAI_API_KEY=your-api-key
-```
-
-This enables Azure OpenAI for all users without requiring individual API keys. For more details, see [environment-variables.md](environment-variables.md).
-
-## Azure OpenAI API Versions
-
-Azure OpenAI supports both traditional deployment-based API and the next-generation v1 API:
-
-### Next-Generation v1 API (Default)
-- **Enabled by default** for GPT-5-like models (GPT-5, GPT-6, o3, o4, etc.)
-- Uses direct `/openai/v1/responses` endpoint without deployment IDs
-- Optimized for advanced reasoning models and new features
-- Can be disabled by setting `AZURE_OPENAI_DISABLE_V1=true`
-
-### Traditional Deployment-Based API
-- Uses `/openai/deployments/{deployment-name}/...` endpoints
-- Required for older models and when v1 API is disabled
-- Needs deployment ID for all API calls
-
-### Known Limitations
-- **Web Search Tool**: Azure OpenAI does not support the `web_search_preview` tool that's available in OpenAI's API
-- Models with web search capabilities will have this feature automatically disabled on Azure
-
-## Setting Up Azure
-
-### Step 1: Azure Account & Subscription
-
-1. Create an account on [azure.microsoft.com](https://azure.microsoft.com/en-us/)
-2. Go to the [Azure Portal](https://portal.azure.com/)
-3. Click on **Create a resource** in the top left corner
-4. Search for **Subscription** and select **[Create Subscription](https://portal.azure.com/#create/Microsoft.Subscription)**
-    - Fill in the required fields and click on **Create**
-    - Note down the **Subscription ID** (e.g., `12345678-1234-1234-1234-123456789012`)
-
-### Step 2: Create Azure OpenAI Resource
-
-For more information, see [Azure: Create and deploy OpenAI](https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/create-resource?pivots=web-portal)
-
-1. Click on **Create a resource** in the top left corner
-2. Search for **OpenAI** and select **[Create OpenAI](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI)**
-3. Fill in the necessary fields on the **Create OpenAI** page
-   ![Creating an OpenAI service](pixels/config-azure-openai-create.png)
-    - Select the subscription
-    - Select a resource group or create a new one
-    - Select the region. **Important**: The region determines which models are available.
-   > Popular regions like **East US**, **West Europe**, and **Australia East** typically have the best model availability. For the latest model availability by region, see [Azure OpenAI Model Availability](https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/models)
-    - Name the service (e.g., `your-openai-api-1234`)
-    - Select a pricing tier (e.g., `S0` for standard)
-    - Select: "All networks, including the internet, can access this resource."
-    - Click on **Review + create** and then **Create**
-
-After creating the resource, you can access the API Keys and Endpoints:
-
-1. Click on **Go to resource** (or navigate to your Azure OpenAI resource)
-2. In the left sidebar, under **Resource Management**, click on **Keys and Endpoint** 
-3. Copy the required information:
-   - **Endpoint**: e.g., 'https://your-resource-name.openai.azure.com/'
-   - **Key**: Copy either KEY 1 or KEY 2 (both work identically)
-
-### Step 3: Deploy Models
-
-By default, Azure OpenAI resource instances don't have models available. You need to deploy the models you want to use.
-
-1. In your Azure OpenAI resource, click on **Model deployments** in the left sidebar
-2. Click on **Create new deployment** 
-3. Fill in the deployment details:
-   - **Select a model**: Choose from available models
-   - **Model version**: Select the latest version or a specific one
-   - **Deployment name**: Give it a meaningful name
-4. Click **Deploy**
-
-Repeat as necessary for each model you want to deploy.
-
-## Resources
-
-- [Azure OpenAI Service Documentation](https://learn.microsoft.com/en-us/azure/ai-services/openai/)
-- [Guide: Create an Azure OpenAI Resource](https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/create-resource?pivots=web-portal)
-- [Azure OpenAI Models](https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/models)

docs/config-feature-browse.md

@@ -1,118 +0,0 @@
-# Browse Functionality in big-AGI 🌐
-
-Allows users to load web pages across various components of `big-AGI`. This feature is supported by Puppeteer-based
-browsing services, which are the most common way to render web pages in a headless environment.
-
-Once configured, the Browsing service provides the following functionality:
-
-- ✅ **Paste a URL**: Simply paste/drag a URL into the chat, and `big-AGI` will load and attach the page (very effective)
-- ✅ **Use /browse**: Type `/browse [URL]` in the chat to command `big-AGI` to load the specified web page
-- ✅ **ReAct**: ReAct will automatically use the `loadURL()` function whenever a URL is encountered
-
-It does not yet support the following functionality:
-
-- ✖️ **Auto-browsing by LLMs**: if an LLM encounters a URL, it will NOT load the page and will likely respond
-  that it cannot browse the web - No technical limitation, just haven't gotten to implement this yet outside of `/react` yet
-
-First of all, you need to procure a Puppteer web browsing service endpoint. `big-AGI` supports services like:
-
-| Service                                                                              | Working | Type        | Location       | Special Features                            |
-|--------------------------------------------------------------------------------------|---------|-------------|----------------|---------------------------------------------|
-| [BrightData Scraping Browser](https://brightdata.com/products/scraping-browser)      | Yes     | Proprietary | Cloud          | Advanced scraping tools, global IP pool     |
-| [Cloudflare Browser Rendering](https://developers.cloudflare.com/browser-rendering/) | ?       | Proprietary | Cloud          | Integrated CDN, optimized browser rendering |
-| ⬇️ [Browserless 2.0](#-browserless-20)                                               | Okay    | OpenSource  | Local (Docker) | Parallelism, debug viewer, advanced APIs    |
-| ⬇️ [Your Chrome Browser (ALPHA)](#-your-own-chrome-browser)                          | Alpha   | Proprietary | Local (Chrome) | Personal, experimental use (ALPHA!)         |
-| other Puppeteer-based WSS Services                                                   | ?       | Varied      | Cloud/Local    | Service-specific features                   |
-
-## Configuration
-
-1. **Procure an Endpoint**
-   - Ensure that your browsing service is running (remote or local) and has a WebSocket endpoint available
-   - Write down the address: `wss://${auth}@{some host}:{port}`, or ws:// for local services on your machine
-
-2. **Configure `big-AGI`**
-   - navigate to **Preferences** > **Tools** > **Browse**
-   - Enter the 'wss://...' connection string provided by your browsing service
-
-3. **Enable Features**: Choose which browse-related features you want to enable:
-   - **Attach URLs**: Automatically load and attach a page when pasting a URL into the composer
-   - **/browse Command**: Use the `/browse` command in the chat to load a web page
-   - **ReAct**: Enable the `loadURL()` function in ReAct for advanced interactions
-
-### 🌐 Browserless 2.0
-
-[Browserless 2.0](https://github.com/browserless/browserless) is a Docker-based service that provides a headless
-browsing experience compatible with `big-AGI`. An open-source solution that simplifies web automation tasks,
-in a scalable manner.
-
-Launch Browserless with:
-
-```bash
-docker run -p 9222:3000 browserless/chrome:latest
-```
-
-Now you can use the following connection string in `big-AGI`: `ws://127.0.0.1:9222`.
-You can also browse to [http://127.0.0.1:9222](http://127.0.0.1:9222) to see the Browserless debug viewer
-and configure some options.
-
-The chat agent won't be able to access the web sites if the browserless container does not have direct Internet access. You can resolve the issue by defining internet proxy for the running container. You can then use the evironment file in the a `docker-compose.yaml
-
-```
- browserless:
-    image: browserless/chrome:latest
-    env_file:
-      - .env
-    ports:
-      - "9222:3000"  # Map host's port 9222 to container's port 3000
-    environment:
-      - MAX_CONCURRENT_SESSIONS=10
-```
-
-You can then add the proxy lines to your `.env` file.
-
-```
-https_proxy=http://PROXY-IP:PROXY-PORT
-http_proxy=http://PROXY-IP:PROXY-PORT
-```
-
-This is how you can define it in a one liner docker
-`docker run --env https_proxy=http://PROXY-IP:PROXY-PORT --env http_proxy=http://PROXY-IP:PROXY-PORT -p 9222:3000 browserless/chrome:latest `
-
-Note: if you are using `docker-compose`, please see the
-[docker/docker-compose-browserless.yaml](docker/docker-compose-browserless.yaml) file for an example
-on how to run `big-AGI` and Browserless simultaneously in a single application.
-
-
-### 🌐 Your own Chrome browser
-
-***EXPERIMENTAL - UNTESTED*** - You can use your own Chrome browser as a browsing service, by configuring it to expose
-a WebSocket endpoint.
-
-- close all the Chrome instances (on Windows, check the Task Manager if still running)
-- start Chrome with the following command line options (on Windows, you can edit the shortcut properties):
-  - `--remote-debugging-port=9222`
-- go to http://localhost:9222/json/version and copy the `webSocketDebuggerUrl` value
-  - it should be something like: `ws://localhost:9222/...`
-- paste the value into the Endpoint configuration (see point 2 in the configuration)
-
-### Server-Side Configuration
-
-You can set the Puppeteer WebSocket endpoint (`PUPPETEER_WSS_ENDPOINT`) in the deployment before running it.
-This is useful for self-hosted instances or when you want to pre-configure the endpoint for all users, and will
-allow your to skip points 2 and 3 above.
-
-Always deploy your own user authentication, authorization and security solution. For this feature, the tRPC
-route that provides browsing service, shall be secured with a user authentication and authorization solution,
-to prevent unauthorized access to the browsing service.
-
-## Support
-
-If you encounter any issues or have questions about configuring the browse functionality, join our community on Discord for support and discussions.
-
-[![Official Discord](https://discordapp.com/api/guilds/1098796266906980422/widget.png?style=banner2)](https://discord.gg/MkH4qj2Jp9)
-
----
-
-Enjoy the enhanced browsing experience within `big-AGI` and explore the web without ever leaving your chat!
-
-Last updated on Feb 27, 2024 ([edit on GitHub](https://github.com/enricoros/big-AGI/edit/main/docs/config-feature-browse.md))

docs/config-feature-google-drive.md

@@ -1,55 +0,0 @@
-# Google Drive Integration
-
-Attach files from Google Drive directly in the chat composer.
-
-## Setup
-
-### 1. Enable APIs
-
-In [Google Cloud Console](https://console.cloud.google.com/):
-
-1. Go to **APIs & Services > Library**
-2. Enable **Google Drive API** and **Google Picker API**
-
-### 2. Configure OAuth
-
-1. Go to **APIs & Services > OAuth consent screen**
-2. Create consent screen (External or Internal)
-3. Add scope: `https://www.googleapis.com/auth/drive.file`
-4. Add test users if in testing mode
-
-### 3. Create Credentials
-
-1. Go to **APIs & Services > Credentials**
-2. Create **OAuth client ID** (Web application)
-3. Add JavaScript origins:
-  - `http://localhost:3000` (dev)
-  - `https://your-domain.com` (prod)
-
-### 4. Set Environment Variable
-
-```bash
-NEXT_PUBLIC_GOOGLE_DRIVE_CLIENT_ID=your-client-id.apps.googleusercontent.com
-```
-
-## Usage
-
-- Click **Drive** button in attachment menu
-
-## Supported Files
-
-| Type            | Export Format       |
-|-----------------|---------------------|
-| Regular files   | Downloaded directly |
-| Google Docs     | Markdown (.md)      |
-| Google Sheets   | CSV (.csv)          |
-| Google Slides   | PDF (.pdf)          |
-| Google Drawings | SVG (.svg)          |
-
-## Troubleshooting
-
-**Picker won't open**: Check `NEXT_PUBLIC_GOOGLE_DRIVE_CLIENT_ID` is set and APIs are enabled.
-
-**OAuth errors**: Verify your domain is in authorized JavaScript origins. Add yourself as test user if app is in testing mode.
-
-**Download fails**: Check file permissions and that Drive API is enabled.

docs/config-local-lmstudio.md

@@ -1,54 +0,0 @@
-# Integrating LM Studio with big-AGI
-
-Quickly set up LM Studio with big-AGI to run local and open LLMs on your computer for enhanced privacy and control over AI interactions.
-
-## Video Tutorial
-
-For a visual step-by-step guide, watch our [YouTube tutorial](https://www.youtube.com/watch?v=MqXzxVokMDk).
-
-[![Running big-AGI locally with LM Studio YouTube Tutorial](http://img.youtube.com/vi/MqXzxVokMDk/0.jpg)](http://www.youtube.com/watch?v=MqXzxVokMDk "Running big-AGI locally with LM Studio")
-
-
-## Quick Setup Guide
-
-### Installing big-AGI
-
-Clone and set up big-AGI:
-
-```bash
-git clone https://github.com/enricoros/big-agi.git && cd big-agi
-npm install # Or: yarn install
-npm run dev # Or: yarn dev
-# If missing dependencies:
-npm install @mui/material # Or: yarn add @mui/material
-```
-
-### Configuring LM Studio
-
-Ensure LM Studio is running (default: [http://localhost:1234](http://localhost:1234)).
-Check the URL and modify if different.
-1. Download local models in LM Studio
-2. Start the LM Studio server
-3. Optionally. Check the logs
-
-### Integration in big-AGI
-
-1. In big-AGI, navigate to **Models** > **Add** > **LM Studio**
-2. Enter the API URL: `http://localhost:1234` (modify if different)
-3. Refresh by clicking on the `Models` button to load models from LM Studio
-
-In addition to using the UI, configuration can also be done using
-[environment variables](environment-variables.md).
-
-## Troubleshooting
-
-- **Missing @mui/material**: Execute `npm install @mui/material` or `yarn add @mui/material`
-- **Connection Issues**: Check LM Studio's URL and ensure it's operational
-
-
-## Further Assistance
-
-Advanced configurations and more:
-
-- big-AGI Community: [Discord](https://discord.gg/MkH4qj2Jp9)
-- LM Studio: [LM Studio home page](https://lmstudio.ai/)

docs/config-local-localai.md

@@ -1,66 +0,0 @@
-# Run your models with `LocalAI` x `big-AGI`
-
-[LocalAI](https://localai.io) lets you run your AI models locally, or in the cloud. It supports text, image, asr, speech, and more models.
-
-We are deepening the integration between the two products. As of the time of writing, we integrate the following features:
-
-- ✅ [Text generation](https://localai.io/features/text-generation/) with GPTs
-- ✅ [Function calling](https://localai.io/features/openai-functions/) by GPTs 🆕
-- ✅ [Model Gallery](https://localai.io/models/) to list and install models
-- ✖️ [Vision API](https://localai.io/features/gpt-vision/) for image chats
-- ✖️ [Image generation](https://localai.io/features/image-generation) with stable diffusion
-- ✖️ [Audio to Text](https://localai.io/features/audio-to-text/)
-- ✖️ [Text to Audio](https://localai.io/features/text-to-audio/)
-- ✖️ [Embeddings generation](https://localai.io/features/embeddings/)
-- ✖️ [Constrained grammars](https://localai.io/features/constrained_grammars/) (JSON output)
-- ✖️ Voice cloning 🆕
-
-_Last updated Feb 21, 2024_
-
-## Guide
-
-### LocalAI installation and configuration
-
-Follow the guide at: https://localai.io/basics/getting_started/
-
-- verify it works by browsing to [http://localhost:8080/v1/models](http://localhost:8080/v1/models)
-  (or the IP:Port of the machine, if running remotely) and seeing listed the model(s) you downloaded
-  listed in the JSON response.
-
-### Integration: chat with LocalAI
-
-- Go to Models > Add a model source of type: **LocalAI**
-- Enter the default address: `http://localhost:8080`, or the address of your localAI cloud instance
-  ![configure models](pixels/config-localai-1-models.png)
-  - If running remotely, replace localhost with the IP of the machine. Make sure to use the **IP:Port** format
-- Load the models (click on `Models 🔄`)
-- Select the model and chat
-
-In addition to using the UI, configuration can also be done using
-[environment variables](environment-variables.md).
-
-### Integration: Models Gallery
-
-> Note: The Gallery Admin feature described below may have been removed or renamed in recent versions of big-AGI.
-
-If the running LocalAI instance is configured with a [Model Gallery](https://localai.io/models/):
-
-- Go to Models > LocalAI
-- Click on `Gallery Admin`
-- Select the models to install, and view installation progress
-  ![img.png](pixels/config-localai-2-gallery.png)
-
-## Troubleshooting
-
-##### Unknown Context Window Size
-
-At the time of writing, LocalAI does not publish the model `context window size`.
-Every model is assumed to be capable of chatting, and with a context window of 4096 tokens.
-Please update the [src/modules/llms/server/models.mappings.ts](../src/modules/llms/server/models.mappings.ts)
-file with the mapping information between LocalAI model IDs and names/descriptions/tokens, etc.
-
-# 🤝 Support
-
-- Hop into the [LocalAI Discord](https://discord.gg/uJAeKSAGDy) for support and questions
-- Hop into the [big-AGI Discord](https://discord.gg/MkH4qj2Jp9) for questions
-- For big-AGI support, please open an issue in our [big-AGI issue tracker](https://bit.ly/agi-request)

docs/config-local-ollama.md

@@ -1,106 +0,0 @@
-# `Ollama` x `big-AGI` :llama:
-
-This guide helps you connect [Ollama](https://ollama.ai) [models](https://ollama.ai/library) to
-[big-AGI](https://big-agi.com) for a professional AI/AGI operation and a good UI/Conversational
-experience. The integration brings the popular big-AGI features to Ollama, including: voice chats,
-editing tools, models switching, personas, and more.
-
-_Last updated Dec 16, 2023_
-
-![config-local-ollama-0-example.png](pixels/config-ollama-0-example.png)
-
-## Quick Integration Guide
-
-1. **Ensure Ollama API Server is Running**: Follow the official instructions to get Ollama up and running on your machine
-   - For detailed instructions on setting up the Ollama API server, please refer to the
-   [Ollama download page](https://ollama.ai/download) and [instructions for linux](https://github.com/jmorganca/ollama/blob/main/docs/linux.md).
-2. **Add Ollama as a Model Source**: In `big-AGI`, navigate to the **Models** section, select **Add a model source**, and choose **Ollama**
-3. **Enter Ollama Host URL**: Provide the Ollama Host URL where the API server is accessible (e.g., `http://localhost:11434`)
-4. **Refresh Model List**: Once connected, refresh the list of available models to include the Ollama models
-   > Optional: use the Ollama Admin interface to see which models are available and 'Pull' them in your local machine. Note
-   that this operation will likely timeout due to Edge Functions timeout on the big-AGI server while pulling, and
-   you'll have to press the 'Pull' button again, until a green message appears.
-5. **Chat with Ollama models**: select an Ollama model and begin chatting with AI personas
-
-In addition to using the UI, configuration can also be done using
-[environment variables](environment-variables.md).
-
-**Visual Configuration Guide**:
-
-* After adding the `Ollama` model vendor, entering the IP address of an Ollama server, and refreshing models:<br/>
-  <img src="pixels/config-ollama-1-models.png" alt="config-local-ollama-1-models.png" width="320">
-
-* The `Ollama` admin panel, with the `Pull` button highlighted, after pulling the "Yi" model:<br/>
-  <img src="pixels/config-ollama-2-admin-pull.png" alt="config-local-ollama-2-admin-pull.png" width="320">
-
-* You can now switch model/persona dynamically and text/voice chat with the models:<br/>
-  <img src="pixels/config-ollama-3-chat.png" alt="config-local-ollama-3-chat.png" width="320">
-
-<br/>
-
-### ⚠️ Network Troubleshooting
-
-If you get errors about the server having trouble connecting with Ollama, please see
-[this message](https://github.com/enricoros/big-AGI/issues/276#issuecomment-1858591483) on Issue #276.
-
-And in brief, make sure the Ollama endpoint is accessible from the servers where you run big-AGI (which could
-be localhost or cloud servers).
-![Ollama Networking Chart](pixels/config-ollama-network.png)
-
-<br/>
-
-### Advanced: Model parameters
-
-For users who wish to delve deeper into advanced settings, `big-AGI` offers additional configuration options, such
-as the model temperature, maximum tokens, etc.
-
-### Advanced: Ollama under a reverse proxy
-
-You can elegantly expose your Ollama server to the internet (and thus make it easier to use from your server-side
-big-AGI deployments) by exposing it on an http/https URL, such as: `https://yourdomain.com/ollama`
-
-On Ubuntu Servers, you will need to install `nginx` and configure it to proxy requests to Ollama.
-
-```bash
-sudo apt update
-sudo apt install nginx
-sudo apt install certbot python3-certbot-nginx
-sudo certbot --nginx -d yourdomain.com
-```
-
-Then, edit the nginx configuration file `/etc/nginx/sites-enabled/default` and add the following block:
-
-```nginx
-    location /ollama/ {
-        proxy_pass http://127.0.0.1:11434/;
-
-        # Disable buffering for the streaming responses (SSE)
-        proxy_set_header Connection '';
-        proxy_http_version 1.1;
-        chunked_transfer_encoding off;
-        proxy_buffering off;
-        proxy_cache off;
-        
-        # Longer timeouts (1hr)
-        keepalive_timeout 3600;
-        proxy_read_timeout 3600;
-        proxy_connect_timeout 3600;
-        proxy_send_timeout 3600;
-    }
-```
-
-Reach out to our community if you need help with this.
-
-<br/>
-
-### Community and Support
-
-Join our community to share your experiences, get help, and discuss best practices:
-
-[![Official Discord](https://discordapp.com/api/guilds/1098796266906980422/widget.png?style=banner2)](https://discord.gg/MkH4qj2Jp9)
-
-
----
-
-`big-AGI` is committed to providing a powerful, intuitive, and privacy-respecting AI experience.
-We are excited for you to explore the possibilities with Ollama models. Happy creating!

docs/config-openrouter.md

@@ -1,33 +0,0 @@
-# OpenRouter Configuration
-
-[OpenRouter](https://openrouter.ai) is a standalone, premium service
-that provides access to a wide range of AI models from multiple providers through a single API.
-This document details the process of integrating OpenRouter with big-AGI.
-
-### 1. OpenRouter Account Setup and API Key Generation
-
-1. Register for an OpenRouter account at [openrouter.ai](https://openrouter.ai) by clicking on Sign In > Continue with Google.
-2. Top up your account (minimum $5) by navigating to [openrouter.ai/account](https://openrouter.ai/account) > Add Credits > Pay with Stripe.
-3. Generate an API key at [openrouter.ai/keys](https://openrouter.ai/keys) > API Key > Generate API Key.
-   - **Remember to copy and securely store your API key** - the key will not be displayed again and will be in the format `sk-or-v1-...`.
-   - Keep the key confidential as it can be used to expend your credits.
-
-### 2. Integrating OpenRouter with big-AGI
-
-1. Launch big-AGI, and navigate to the AI **Models** settings.
-2. Add a Vendor, and select **OpenRouter**.
-   ![feature-openrouter-add.png](pixels/feature-openrouter-add.png)
-3. Input the API key into the **OpenRouter API Key** field, and load the Models.
-   ![feature-openrouter-configure.png](pixels/feature-openrouter-configure.png)
-4. Models from all supported providers will now be accessible and selectable in the application.
-
-In addition to using the UI, configuration can also be done using
-[environment variables](environment-variables.md).
-
-### Pricing
-
-OpenRouter independently manages its service and pricing and is not affiliated with big-AGI.
-For more detailed information, please visit [this page](https://openrouter.ai/docs#models).
-
-Please note that running large models can be costly and may rapidly consume credits.
-Check model pricing on the OpenRouter website before use.

docs/customizations.md

@@ -1,112 +0,0 @@
-# Customizing and Creating Derivative Applications
-
-This document outlines how to develop applications derived from big-AGI.
-
-## Manual Customization
-
-Application customization _requires manual code modifications or the use of environment variables_. Currently, **there is no admin panel to "managed" deployment customization** for enterprise use cases.
-
-| Required Code Alteration                                                              | Not Required                                                                                                              |
-|---------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------|
-| - Persona changes<br>- UI theme customization<br>- Feature additions or modifications | - Setting API keys in [environment variables](environment-variables.md)<br>- Toggling features with environment variables |
-| Apply these to the source code before building the application                        | Set these post-build on local machines or cloud deployment, before application launch                                     |
-
-<br/>
-
-## Code Alterations
-
-Start by creating a fork of the [big-AGI repository](https://github.com/enricoros/big-AGI) on GitHub for a personal development space.
-Understand the Architecture: big-AGI uses Next.js, React for the front end, and Node.js (Next.js edge functions) for the back end.
-
-### Add Authentication
-
-This necessitates a code change (file renaming) before build initiation, detailed in [deploy-authentication.md](deploy-authentication.md).
-
-### Increase Vercel Functions Timeout
-
-For long-running operations, Vercel allows paid deployments to increase the timeout on Functions.
-Note that this applies to old-style Vercel Functions (based on Node.js) and not the new Edge Functions.
-
-At time of writing, big-AGI has only 2 operations that run on Node.js Functions:
-browsing (fetching web pages) and sharing. They both can exceed 10 seconds, especially
-when fetching large pages or waiting for websites to be completed.
-
-From the Vercel Project > Settings > General > Build & Development Settings,
-you can for instance set the build command to:
-
-```bash
-next build
-```
-
-### Change the Personas (v1.x only)
-
-Edit the `src/data.ts` file to customize personas. This file houses the default personas. You can add, remove, or modify these to meet your project's needs.
-
-- [ ] Modify `src/data.ts` to alter default personas
-
-### Change the UI
-
-Adapt the UI to match your project's aesthetic, incorporate new features, or exclude unnecessary ones.
-
-- [ ] Adjust `src/common/app.theme.ts` for theme changes: colors, spacing, button appearance, animations, etc
-- [ ] Modify `src/common/app.release.ts` to alter the application's name
-- [ ] Update `src/common/app.nav.ts` to revise the navigation bar
-
-### Add a Message of the Day
-
-You can display a temporary announcement banner at the top of the app using the `NEXT_PUBLIC_MOTD` environment variable.
-
-- Set this variable in your deployment environment
-- The message supports template variables:
-  - `{{app_build_hash}}`: Current git commit hash
-  - `{{app_build_pkgver}}`: Package version
-  - `{{app_build_time}}`: Build timestamp as date
-  - `{{app_deployment_type}}`: Deployment type (local, docker, vercel, etc.)
-- Users can dismiss the message (until next page refresh)
-- Use it for version announcements, maintenance notices, or feature highlights
-
-Example: `NEXT_PUBLIC_MOTD=🚀 New features available in {{app_build_pkgver}}! Try the improved Beam.`
-
-## Testing & Deployment
-
-Test your application thoroughly using local development (refer to README.md for local build instructions). Deploy using your preferred hosting service. big-AGI supports deployment on platforms like Vercel, Docker, or any Node.js-compatible service, especially those supporting NextJS's "Edge Runtime."
-
-- [deploy-cloudflare.md](deploy-cloudflare.md): for Cloudflare Pages deployment (limited support)
-- [deploy-docker.md](deploy-docker.md): for Docker deployment instructions and examples
-- [deploy-k8s.md](deploy-k8s.md): for Kubernetes deployment instructions and examples
-
-## Debugging
-
-The application includes a client-side logging system. You can view recent logs via the UI (Settings > Tools > Logs).
-
-For deeper debugging during development:
-
-1. **Debug Page**: Access the `/info/debug` page for an overview of the application's environment, configuration, API status, and environment variables available to the client.
-2. **Conditional Breakpoints**: To automatically pause execution in your browser's developer tools when critical errors (`error`, `critical`, `DEV` levels) are logged to the console, set the following environment variable in your local `.env.local` file and restart your development server:
-   ```bash
-   NEXT_PUBLIC_DEBUG_BREAKS=true
-   ```
-   This allows you to inspect the application state at the exact moment an important error occurs. This feature only works in development mode (`npm run dev`) and requires the environment variable to be explicitly set to `true`.
-
-<br/>
-
-## Community Projects - Share Your Project
-
-After deployment, share your project with the community. We will link to your project to help others discover and learn from your work.
-
-| Project                                                                                                                                                        | Features                                                                                                  | GitHub                                                                              |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
-| 🚀 CoolAGI: Where AI meets Imagination<br/>![CoolAGI Logo](https://github.com/nextgen-user/freegpt4plus/assets/150797204/9b0e1232-4791-4d61-b949-16f9eb284c22) | Code Interpreter, Vision, Mind maps, Web Searches, Advanced Data Analytics, Large Data Handling and more! | [nextgen-user/CoolAGI](https://github.com/nextgen-user/CoolAGI)                     |
-| HL-GPT                                                                                                                                                         | Fully remodeled UI                                                                                        | [harlanlewis/nextjs-chatgpt-app](https://github.com/harlanlewis/nextjs-chatgpt-app) |
-
-For public projects, update your README.md with your modifications and submit a pull request to add your project to our list, aiding in its discovery.
-
-<br/>
-
-## Best Practices
-
-- **Stay Updated**: Frequently merge updates from the main big-AGI repository to incorporate bug fixes and new features.
-- **Keep It Open Source**: Consider maintaining your derivative as open source to foster community contributions.
-- **Engage with the Community**: Leverage platforms like GitHub, Discord, or Reddit for feedback, collaboration, and project promotion.
-
-Developing a derivative application is an opportunity to explore new possibilities with AI and share your innovations with the global community. We look forward to seeing your contributions.

docs/deploy-analytics.md

@@ -1,80 +0,0 @@
-# big-AGI Analytics
-
-The open-source big-AGI project provides support for the following analytics services:
-
-- **Google Analytics 4**: manual setup required
-- **PostHog Analytics**: manual setup required
-- **Vercel Analytics**: automatic when deployed to Vercel
-
-The following is a quick overview of the Analytics options for the deployers of this open-source project.
-big-AGI is deployed to many large-scale and enterprise though various ways (custom builds, Docker, Vercel, Cloudflare, etc.),
-and this guide is for its customization.
-
-## Service Configuration
-
-### Google Analytics 4
-
-- Why: user engagement and retention, performance insights, personalization, content optimization
-- What: https://support.google.com/analytics/answer/11593727
-
-Google Analytics 4 (GA4) is a powerful tool for understanding user behavior and engagement.
-This can help optimize big-AGI, understanding which features are needed/users and which aren't.
-
-To enable Google Analytics 4, you need to set the `NEXT_PUBLIC_GA4_MEASUREMENT_ID` environment variable
-before starting the local build or the docker build (i.e. at build time), at which point the
-server/container will be able to report analytics to your Google Analytics 4 property.
-
-As of Feb 27, 2024, this feature is in development.
-
-### PostHog Analytics
-
-- Why: feature usage tracking, user journeys, conversion optimization, product analytics
-- What: page views, page leave events, user interactions, and deployment context
-
-PostHog provides comprehensive product analytics with privacy controls. It helps understand how users interact with big-AGI's features, identify opportunities for improvement, and optimize the user experience.
-
-To enable PostHog, set the `NEXT_PUBLIC_POSTHOG_KEY` environment variable at build time. PostHog is configured with tracking optimization and privacy in mind:
-
-- Uses a proxy endpoint (`/a/ph`) to avoid ad blockers
-- Respects user opt-out preferences via local storage
-- Tracks only essential information without PII
-- Adds deployment context for better segmentation
-
-The implementation follows PostHog's best practices for Next.js applications and includes manual page view tracking for proper single-page application support.
-
-### Vercel Analytics
-
-- Why: understand coarse traction, and identify deployment issues - all without tracking individual users
-- What: top pages, top referrers, country of origin, operating system, browser, and page speed metrics
-
-Vercel Analytics and Speed Insights are local API endpoints deployed to your domain, so everything stays within your
-domain. Furthermore, the Vercel Analytics service is privacy-friendly, and does not track individual users.
-
-This service is avaialble to system administrators when deploying to Vercel. It is automatically enabled when deploying to Vercel.
-The code that activates Vercel Analytics is located in the `pages/_app.tsx` file:
-
-```tsx
-const MyApp = ({ Component, emotionCache, pageProps }: MyAppProps) => <>
-  ...
-  {Is.Deployment.VercelFromFrontend && <VercelAnalytics debug={false} />}
-  {Is.Deployment.VercelFromFrontend && <VercelSpeedInsights debug={false} sampleRate={1 / 2} />}
-  ...
-</>;
-```
-
-When big-AGI is served on Vercel hosts, the `process.env.NEXT_PUBLIC_VERCEL_URL` environment variable is trueish, and
-analytics will be sent by default to the Vercel Analytics service which is deployed by Vercel IF configured from the
-Vercel project dashboard.
-
-In summary: to turn it on: activate the `Analytics` service in the Vercel project dashboard.
-
-## Configurations
-
-| Scope                                                                                                                   | Default                   | Description / Instructions                                                                                                                                                  |
-|-------------------------------------------------------------------------------------------------------------------------|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| Your **Source** builds of big-AGI                                                                                       | None                      | **Google Analytics**: set environment variable at build time · **PostHog**: set environment variable at build time · **Vercel**: enable Vercel Analytics from the dashboard | 
-| Your **Docker** builds of big-AGI                                                                                       | None                      | (**Vercel**: n/a) · **Google Analytics**: set environment variable at `docker build` time · **PostHog**: set environment variable at `docker build` time.                   |
-| [get.big-agi.com](https://get.big-agi.com) (**Big-AGI 1.x Legacy**)                                                     | Vercel + Google + PostHog | The main website ([privacy policy](https://big-agi.com/privacy)) hosted for free for anyone.                                                                                |
-| [prebuilt Docker packages](https://github.com/enricoros/big-AGI/pkgs/container/big-agi) (**Big-AGI 1.x**, 'latest' tag) | Google Analytics          | **Vercel**: n/a · **Google Analytics**: set to the big-agi.com Google Analytics for analytics and improvements · **PostHog**: n/a                                           |
-
-Note: this information is updated as of March 3, 2025 and can change at any time.

docs/deploy-authentication.md

@@ -1,45 +0,0 @@
-# Authentication
-
-`big-AGI` does not come with built-in authentication. To secure your deployment, you can implement authentication
-in one of the following ways:
-
-1. Build `big-AGI` with support for ⬇️ [HTTP Authentication](#http-authentication)
-2. Utilize user authentication features provided by your ⬇️ [cloud deployment platform](#cloud-deployments-authentication)
-3. Develop a custom authentication solution
-
-<br/>
-
-### HTTP Authentication
-
-[HTTP Basic Authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) is a simple method
-to secure your application.
-
-To enable it in `big-AGI`, you **must manually build the application**:
-
-- Build `big-AGI` with HTTP authentication enabled:
-  - Clone the repository
-  - Rename `middleware_BASIC_AUTH.ts` to `middleware.ts`
-  - Build: usual simple build procedure (e.g. [Deploy manually](installation.md#Local-Production-build) or [Deploying with Docker](deploy-docker.md))
-
-- Configure the following [environment variables](environment-variables.md) before launching `big-AGI`:
-```dotenv
-HTTP_BASIC_AUTH_USERNAME=<your username>
-HTTP_BASIC_AUTH_PASSWORD=<your password>
-```
-
-- Start the application 🔒
-
-<br/>
-
-### Cloud Deployments Authentication
-
-> This approach allows you to enable authentication without rebuilding the application by using the features
-> provided by your cloud platform to manage user accounts and access.
-
-Many cloud deployment platforms offer built-in authentication mechanisms. Refer to the platform's documentation
-for setup instructions:
-
-1. [CloudFlare Access / Zero Trust](https://www.cloudflare.com/zero-trust/products/access/)
-2. [Vercel Authentication](https://vercel.com/docs/security/deployment-protection/methods-to-protect-deployments/vercel-authentication)
-3. [Vercel Password Protection](https://vercel.com/docs/security/deployment-protection/methods-to-protect-deployments/password-protection)
-4. Let us know when you test more solutions (Heroku, AWS IAM, Google IAP, etc.)

docs/deploy-cloudflare.md

@@ -1,70 +1,55 @@
----
-unlisted: true
----
+# Deploying Next.js App on Cloudflare Pages
 
-# Deploying a Next.js App on Cloudflare Pages
+Follow these steps to deploy your Next.js app on Cloudflare Pages. This guide is based on
+the [official Cloudflare developer documentation](https://developers.cloudflare.com/pages/framework-guides/deploy-a-nextjs-site/),
+with a few additional steps.
 
-> WARNING: Cloudflare Pages only supports Edge Runtime functions, not the full Node.js runtime.
->
-> The cloud router in this project requires a Node.js runtime for Supabase SDK, authentication,
-> sync, and other server-side features that cannot run on Cloudflare's edge runtime.
->
-> Workaround: Step 3.4. has been added below, to DELETE the Node.js cloud router - which means that some
-> parts of this application will not work.
->  - [Side effects](https://github.com/enricoros/big-agi/blob/main/src/modules/trade/server/trade.router.ts):
->     Sharing functionality, import from ChatGPT share, and post to Paste.GG will not work
->  - Cloud features (sync, auth, payments) will not be available
->  - See [Issue 174](https://github.com/enricoros/big-agi/issues/174).
+## Step 1: Fork the Repository
 
-This guide provides steps to deploy your Next.js app on Cloudflare Pages.
-It is based on the [official Cloudflare developer documentation](https://developers.cloudflare.com/pages/framework-guides/deploy-a-nextjs-site/),
-with some additional steps.
+Fork the repository to your own GitHub account.
 
-## Step 1: Repository Forking
+## Step 2: Connect Cloudflare Pages to Your GitHub Account
 
-Fork the repository to your personal GitHub account.
+1. Go to the Cloudflare Pages section and click the `Create a project` button.
+2. Click `Connect To Git` and give Cloudflare Pages either All GitHub account Repo access or selected Repo access. We
+   recommend using selected Repo access and selecting the forked repo from step 1.
 
-## Step 2: Linking Cloudflare Pages to Your GitHub Account
+## Step 3: Setup Build and Deployments
 
-1. Navigate to the Cloudflare Pages section and click on the `Create a project` button.
-2. Click `Connect To Git` and grant Cloudflare Pages access to either all GitHub account repositories or selected repositories.
-   We recommend using selected Repo access and selecting the forked repository from step 1.
+1. Once you select the forked GitHub repo, click the `Begin Setup` button.
+2. On this page, set your `Project name`, `Production branch` (e.g., main), and your Build settings.
+3. Select `Next.js` from the `Framework preset` dropdown menu.
+4. Leave the preset filled Build command and Build output directory as preset defaults.
+5. Set `Environmental variables` (advanced) on this page to configure some variables as follows:
 
-## Step 3: Configuring Build and Deployments
+| Variable                  | Value   |
+|---------------------------|---------|
+| `GO_VERSION`              | `1.16`  |
+| `NEXT_TELEMETRY_DISABLED` | `1`     |
+| `NODE_VERSION`            | `17`    |
+| `PHP_VERSION`             | `7.4`   |
+| `PYTHON_VERSION`          | `3.7`   |
+| `RUBY_VERSION`            | `2.7.1` |
 
-1. After selecting the forked GitHub repository, click the **Begin Setup** button
-2. On this page, set your **Project name**, **Production branch** (e.g., main), and your Build settings
-3. Choose `Next.js` from the **Framework preset** dropdown menu
-4. Set a custom **Build Command**:
-    - `rm app/api/cloud/[trpc]/route.ts && npx @cloudflare/next-on-pages@1`
-    - see the tradeoffs for this deletion on the notice at the top
-5. Keep the **Build output directory** as default
-6. Click the **Save and Deploy** button
+6. Click the `Save and Deploy` button.
 
-## Step 4: Monitoring the Deployment Process
+## Step 4: Monitor the Deployment Process
 
-Observe the process as it initializes your build environment, clones the GitHub repository, builds the application, and deploys it
-to the Cloudflare Network. Once complete, proceed to the project you created.
+Watch the process run to initialize your build environment, clone the GitHub repo, build the application, and deploy to
+the Cloudflare Network. Once that is done, proceed to the project you created.
 
-## Step 5: Required: Set the `nodejs_compat` compatibility flag
-
-1. Navigate to the [Settings > Functions](https://dash.cloudflare.com/?to=/:account/pages/view/:pages-project/settings/functions) page of your newly created project
-2. Scroll to `Compatibility flags` and enter "`nodejs_compat`" for both **Production** and **Preview** environments.
-   It should look like this: ![](pixels/config-deploy-cloudflare-compat2.png)
-3. Re-deploy your project for the new flags to take effect
-
-## Step 6: (Optional) Custom Domain Configuration
+## Step 5: Set up a Custom Domain
 
 Use the `Custom domains` tab to set up your domain via CNAME.
 
-## Step 7: (Optional) Access Policy and Web Analytics Configuration
+## Step 6: Configure Access Policy and Web Analytics
 
-Navigate to the `Settings` page and enable the following settings:
+Go to the `Settings` page and enable the following settings:
 
 1. Access Policy: Restrict [preview deployments](https://developers.cloudflare.com/pages/platform/preview-deployments/)
    to members of your Cloudflare account via one-time pin and restrict primary `*.YOURPROJECT.pages.dev` domain.
-   Refer to [Cloudflare Pages known issues](https://developers.cloudflare.com/pages/platform/known-issues/#enabling-access-on-your-pagesdev-domain)
-   for more details.
+   See [Cloudflare Pages known issues](https://developers.cloudflare.com/pages/platform/known-issues/#enabling-access-on-your-pagesdev-domain)
+   for more information.
 2. Enable Web Analytics.
 
-Congratulations! You have successfully deployed your Next.js app on Cloudflare Pages.
+Now you have successfully deployed your Next.js app on Cloudflare Pages.

docs/deploy-database.md

@@ -1,66 +0,0 @@
-**Connecting Your Database for Enhanced Features:**
-
-This guide outlines the database options and setup steps for enabling features like Chat Link Sharing in your application.
-
-### Choose Your Database:
-
-**1. Serverless Postgres (default):**
-
-- Available on Vercel, Neon, and other platforms.
-- Less feature-rich but a suitable option depending on your needs.
-- **Connection String:** Replace placeholders with your Postgres credentials.
-  - `postgres://USER:PASS@SOMEHOST.postgres.vercel-storage.com/SOMEDB?pgbouncer=true&connect_timeout=15`
-
-**2. MongoDB Atlas (alternative):**
-
-- **Highly Recommended:** More than a database, it's a data platform. MongoDB Atlas is a robust cloud-based platform that offers scalability, security, and a suite of developer tools. No need for a separate vector database, you can query your vector embeddings right within your operational database!
-- **Additional Features:** MongoDB Atlas is packed with unique features designed to streamline the development process such as: Atlas App Services, Atlas search (with vector search), Atlas charts, Data Federation, and more.
-- **Connection String:** Replace placeholders with your Atlas credentials.
-  - `mongodb://USER:PASS@CLUSTER-NAME.mongodb.net/DATABASE-NAME?retryWrites=true&w=majority`
-
-### Environment Variables:
-
-#### Postgres:
-
-| Variable                              |                                                                                                      |
-|---------------------------------------|------------------------------------------------------------------------------------------------------|
-| `POSTGRES_PRISMA_URL`                 | `postgres://USER:PASS@SOMEHOST.postgres.vercel-storage.com/SOMEDB?pgbouncer=true&connect_timeout=15` |
-| `POSTGRES_URL_NON_POOLING` (optional) | URL for the Postgres database without pooling (specific use cases)                                   |
-
-#### MongoDB:
-
-| Variable  |                                                                                          |
-|-----------|------------------------------------------------------------------------------------------|
-| `MDB_URI` | `mongodb://USER:PASS@CLUSTER-NAME.mongodb.net/DATABASE-NAME?retryWrites=true&w=majority` |
-
-### MongoDB Atlas + Prisma
-
-When using MongoDB Atlas, you'll need to make the below changes to the file [`src/server/prisma/schema.prisma`](../src/server/prisma/schema.prisma).
-
-```
-...
-datasource db {
-  provider  = "mongodb"
-  url       = env("MDB_URI")
-}
-
-//
-// Storage of Linked Data
-//
-model LinkStorage {
-  id String @id @default(uuid()) @map("_id")
-
-// ...rest of file
-```
-
-### Initial Setup Steps:
-
-1. **Run `npx prisma db push`:** Create or update the database schema (run once after connecting).
-
-### Additional Resources:
-
-- Prisma documentation: [https://www.prisma.io/docs/](https://www.prisma.io/docs/)
-- MongoDB Atlas: [https://www.mongodb.com/atlas/database](https://www.mongodb.com/atlas/database)
-- Atlas App Services: [https://www.mongodb.com/docs/atlas/app-services/](https://www.mongodb.com/docs/atlas/app-services/)
-- Atlas vector search: [https://www.mongodb.com/products/platform/atlas-vector-search/](https://www.mongodb.com/products/platform/atlas-vector-search)
-- Atlas Data Federation: [https://www.mongodb.com/products/platform/atlas-data-federation](https://www.mongodb.com/products/platform/atlas-data-federation)

docs/deploy-docker.md

@@ -1,94 +1,26 @@
-# Deploying `big-AGI` with Docker
+# Deploy `big-AGI` with Docker 🐳
 
-Utilize Docker containers to deploy the big-AGI application for an efficient and automated deployment process.
-Docker ensures faster development cycles, easier collaboration, and seamless environment management.
+Deploy the big-AGI application using Docker containers for a consistent, efficient, and automated deployment process. Enjoy faster development cycles, easier collaboration, and seamless environment management. 🚀
 
-## Build and run your container 🔧
+Docker is a platform for developing, packaging, and deploying applications as lightweight containers, ensuring consistent behavior across environments.
 
-1. **Clone big-AGI**
-   ```bash
-   git clone https://github.com/enricoros/big-agi.git
-   cd big-agi
-   ```
-2. **Build the Docker Image**: Build a local docker image from the provided Dockerfile:
-   ```bash
-   docker build -t big-agi .
-   ```
-3. **Run the Docker Container**: start a Docker container from the newly built image,
-   and expose its http port 3000 to your `localhost:3000` using:
-   ```bash
-   docker run -d -p 3000:3000 big-agi
-   ```
-4. Browse to [http://localhost:3000](http://localhost:3000)
+## `big-AGI` Docker Components
 
-<br/>
+The big-AGI repository includes a Dockerfile and a GitHub Actions workflow for building and publishing a Docker image of the application.
 
-## Run Official Containers 📦
+### Dockerfile
 
-`big-AGI` is pre-built from source code and published as a Docker image on the GitHub Container Registry (ghcr).
-The build process is transparent, and happens via GitHub Actions, as described in the
-file.
+The [`Dockerfile`](../Dockerfile) sets up a Node.js environment, installs dependencies, and creates a production-ready version of the application.
 
-### Official Images: [ghcr.io/enricoros/big-agi](https://github.com/enricoros/big-agi/pkgs/container/big-agi)
+### GitHub Actions Workflow
 
-#### Available Tags
+The [`.github/workflows/docker-image.yml`](../.github/workflows/docker-image.yml) file automates building and publishing the Docker image when changes are pushed to the `main` branch.
 
-- **`:latest`** / **`:stable`** - Latest stable release (recommended)
-- **`:development`** - Main branch (bleeding edge)
-- **`:v2.0.0`** - Specific versions
+## Deploy Steps
 
-#### Run using *docker* 🚀
+1. Clone the big-AGI repository
+2. Navigate to the project directory
+3. Build the Docker image using the provided Dockerfile
+4. Run the Docker container with the built image
 
-```bash
-docker run -d -p 3000:3000 ghcr.io/enricoros/big-agi:latest
-```
-
-#### Run using *docker-compose* 🚀
-
-If you have Docker Compose installed, you can run the Docker container with `docker-compose up`
-to pull the Docker image (if it hasn't been pulled already) and start a Docker container. If you want to
-update the image to the latest version, you can run `docker-compose pull` before starting the service.
-
-```bash
-docker-compose up -d
-```
-
-### Make Local Services Visible to Docker 🌐
-
-To make local services running on your host machine accessible to a Docker container, such as a
-[Browseless](./config-feature-browse.md) service or a local API, you can follow this simplified guide:
-
-| Operating System  | Steps to Make Local Services Visible to Docker                                                                                                                                                                                                                                                                                                                                               |
-|:------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| Windows and macOS | Use the special DNS name `host.docker.internal` to refer to the host machine from within the Docker container. No additional network configuration is required. Access local services using `host.docker.internal:<PORT>`.                                                                                                                                                                   |
-| Linux             | Two options: *A*. Use <ins>--network="host"</ins> (`docker run --network="host" -d big-agi`) when running the Docker container to merge the container within the host network stack; however, this reduces container isolation. Alternatively: *B*. Connect to local services <ins>using the host's IP address</ins> directly, as host.docker.internal is not available by default on Linux. |
-
-<br/>
-
-### Reverse Proxy Configuration
-
-A reverse proxy is a server that sits in front of big-AGI's container and can forwards web
-requests to it. Often used to run multiple web applications, expose them to the internet,
-increase security.
-
-If you're deploying big-AGI behind a reverse proxy, you may want to see
-our [Reverse Proxy Deployment Guide](deploy-reverse-proxy.md) for more information.
-
-<br/>
-
-### More Information
-
-The [`Dockerfile`](../Dockerfile) describes how to create a Docker image. It establishes a Node.js environment,
-installs dependencies, and creates a production-ready version of the application as a local container.
-
-The [`docker-compose.yaml`](../docker-compose.yaml) file is configured to run the
-official image (big-agi:latest). This file is used to define the `big-agi` service, to expose
-port 3000 on the host, and launch big-AGI within the container (startup command).
-
-The [`.github/workflows/docker-image.yml`](../.github/workflows/docker-image.yml) file is used
-to build the Official Docker images and publish them to the GitHub Container Registry (ghcr).
-The build process is transparent and happens via GitHub Actions.
-
-<br/>
-
-Leverage Docker's capabilities for a reliable and efficient big-AGI deployment!
+Embrace the benefits of Docker for a reliable and efficient big-AGI deployment. 🎉

docs/deploy-k8s.md

@@ -1,85 +0,0 @@
-# Deploy `big-AGI` with Kubernetes ☸️
-
-In this tutorial, we will guide you through the process of deploying big-AGI
-in a Kubernetes environment using the kubectl command-line tool.
-
-## First Deployment
-
-### Step 1: Clone the big-AGI repository
-
-```bash
-$ git clone https://github.com/enricoros/big-agi
-$ cd ./big-agi/docs/k8s
-```
-
-### Step 2: Create the namespace
-
-```bash
-$ kubectl create namespace ns-big-agi
-```
-
-### Step 3: Fill in the key information into env-secret.yaml
-
-All variables are optional. By default, Kubernetes Secret uses Base64 for
-encode/decode, so please don't do a git commit after filling in the keys
-to avoid leaking sensitive information.
-
-We provide an empty `env-secret.yaml` file as a template.
-You can fill in the necessary information using a text editor.
-
-```bash
-$ nano env-secret.yaml
-```
-
-### Step 4: Deploying Kubernetes Resources
-
-```bash
-$ kubectl apply -f big-agi-deployment.yaml -f env-secret.yaml
-```
-
-### Step 5: Verifying the Resource Statuses
-
-```bash
-$ kubectl -n ns-big-agi get svc,pod,deployment
-NAME                  TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
-service/svc-big-agi   ClusterIP   10.0.198.118   <none>        3000/TCP   63m
-
-NAME                                     READY   STATUS    RESTARTS   AGE
-pod/deployment-big-agi-xxxxxxxx-yyyyy    1/1     Running   0          39m
-
-NAME                              READY   UP-TO-DATE   AVAILABLE   AGE
-deployment.apps/deployment-big-agi   1/1     1            1           63m
-```
-
-### Step 6: Testing the Service
-
-You can test the service by port-forwarding the service to your local machine:
-
-```bash
-$ kubectl -n ns-big-agi port-forward service/svc-big-agi 3000
-Forwarding from 127.0.0.1:3000 -> 3000
-Forwarding from [::1]:3000 -> 3000
-```
-
-Now you can access the service at `http://localhost:3000`, and you should see the big-AGI homepage.
-
-## Updating big-AGI
-
-To update big-AGI to the latest version:
-
-1. Pull the latest changes from the repository:
-   ```bash
-   $ git pull origin main
-   ```
-
-2. Apply the updated deployment:
-   ```bash
-   $ kubectl apply -f big-agi-deployment.yaml
-   ```
-
-This will trigger a rolling update of the deployment with the latest image.
-
-**Note**: If you're deploying big-AGI behind a reverse proxy, you may need to configure
-your proxy to support streaming. See our [Reverse Proxy Deployment Guide](deploy-reverse-proxy.md) for more information.
-
-Note: For production use, consider setting up an Ingress Controller or Load Balancer instead of using port-forward.

docs/deploy-reverse-proxy.md

@@ -1,58 +0,0 @@
-# Advanced: Deploying big-AGI behind a Reverse Proxy
-
-Note: if you don't have a reverse proxy set up, you can skip this guide.
-
-If you're deploying big-AGI behind a reverse proxy, you may want to configure your proxy to support streaming output.
-This guide provides instructions on how to configure your reverse proxy to support streaming output from big-AGI.
-
-This is for advanced deployments, and you should have a basic understanding of how reverse proxies work.
-
-## Nginx Configuration
-
-If you're using Nginx as your reverse proxy, add the following configuration to your server block:
-
-```nginx
-server {
-    listen 80;
-    server_name your-domain.com;
-
-    location / {
-        # ...your specific proxy_pass configuration, example below...
-        proxy_pass http://localhost:3000;  # Assuming big-AGI is running on port 3000
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection 'upgrade';
-        proxy_set_header Host $host;
-        proxy_cache_bypass $http_upgrade;
-        # ...
-
-        # Important: Disable buffering for the streaming responses (SSE)
-        chunked_transfer_encoding on;   # Turn on chunked transfer encoding
-        proxy_buffering off;            # Turn off proxy buffering
-        proxy_cache off;                # Turn off caching
-        tcp_nodelay on;                 # Turn on TCP NODELAY option, disable delay ACK algorithm
-        tcp_nopush on;                  # Turn on TCP NOPUSH option, disable Nagle algorithm
-
-        # Important: Longer timeouts (5 min)
-        keepalive_timeout 300;
-        proxy_connect_timeout 300;
-        proxy_read_timeout 300;
-        proxy_send_timeout 300;
-    }
-}
-```
-
-This configuration disables caching and buffering, enables chunked transfer encoding, and adjusts TCP settings to optimize for streaming content.
-
-## Troubleshooting
-
-If you're experiencing issues with streaming not working, especially when deploying behind a reverse proxy,
-ensure that your proxy is configured to support streaming output as described above.
-
-## Additional Resources
-
-- For Docker deployments, see our [Docker Deployment Guide](deploy-docker.md)
-- For Kubernetes deployments, see our [Kubernetes Deployment Guide](deploy-k8s.md)
-- For general installation instructions, see our [Installation Guide](installation.md)
-
-If you continue to experience issues, please reach out to our [community support channels](../README.md#-get-involved).

docs/docker/docker-compose-browserless.yaml

@@ -1,30 +0,0 @@
-# This file is used to run `big-AGI` and `browserless` with Docker Compose.
-#
-# The two containers are linked together and `big-AGI` is configured to use `browserless`
-# as its Puppeteer endpoint (from the containers intranet, it is available browserless:3000).
-#
-# From your host, you can access big-AGI on http://127.0.0.1:3000 and browserless on http://127.0.0.1:9222.
-#
-# To start the containers, run:
-#   docker-compose -f docs/docker/docker-compose-browserless.yaml up
-
-version: '3.9'
-
-services:
-  big-agi:
-    image: ghcr.io/enricoros/big-agi:latest
-    ports:
-      - "3000:3000"
-    env_file:
-      - .env
-    environment:
-      - PUPPETEER_WSS_ENDPOINT=ws://browserless:3000
-    depends_on:
-      - browserless
-
-  browserless:
-    image: browserless/chrome:latest
-    ports:
-      - "9222:3000"  # Map host's port 9222 to container's port 3000
-    environment:
-      - MAX_CONCURRENT_SESSIONS=10

docs/environment-variables.md

@@ -1,179 +0,0 @@
-# Environment Variables
-
-This document provides an explanation of the environment variables used in the big-AGI application.
-
-**All variables are optional**; and _UI options_ take precedence over _backend environment variables_,
-which take place over _defaults_. This file is kept in sync with [`../src/server/env.server.ts`](../src/server/env.server.ts).
-
-### Setting Environment Variables
-
-Environment variables can be set by creating a `.env` file in the root directory of the project.
-
-The following is an example `.env` for copy-paste convenience:
-
-```bash
-# Database (Postgres)
-POSTGRES_PRISMA_URL=
-POSTGRES_URL_NON_POOLING=
-
-# Database (MongoDB)
-MDB_URI=
-
-# LLMs
-OPENAI_API_KEY=
-OPENAI_API_HOST=
-OPENAI_API_ORG_ID=
-ALIBABA_API_HOST=
-ALIBABA_API_KEY=
-AZURE_OPENAI_API_ENDPOINT=
-AZURE_OPENAI_API_KEY=
-ANTHROPIC_API_KEY=
-ANTHROPIC_API_HOST=
-BEDROCK_BEARER_TOKEN=
-BEDROCK_ACCESS_KEY_ID=
-BEDROCK_SECRET_ACCESS_KEY=
-BEDROCK_SESSION_TOKEN=
-BEDROCK_REGION=
-DEEPSEEK_API_KEY=
-GEMINI_API_KEY=
-GROQ_API_KEY=
-LOCALAI_API_HOST=
-LOCALAI_API_KEY=
-MISTRAL_API_KEY=
-MOONSHOT_API_KEY=
-OLLAMA_API_HOST=
-OPENPIPE_API_KEY=
-OPENROUTER_API_KEY=
-PERPLEXITY_API_KEY=
-TOGETHERAI_API_KEY=
-XAI_API_KEY=
-
-# Model Observability: Helicone
-HELICONE_API_KEY=
-
-# Browse
-PUPPETEER_WSS_ENDPOINT=
-
-# Search
-GOOGLE_CLOUD_API_KEY=
-GOOGLE_CSE_ID=
-
-# Text-To-Speech: ElevenLabs
-ELEVENLABS_API_KEY=
-ELEVENLABS_API_HOST=
-ELEVENLABS_VOICE_ID=
-
-# Backend HTTP Basic Authentication (see `deploy-authentication.md` for turning on authentication)
-HTTP_BASIC_AUTH_USERNAME=
-HTTP_BASIC_AUTH_PASSWORD=
-
-
-# Frontend variables 
-NEXT_PUBLIC_MOTD=
-NEXT_PUBLIC_GA4_MEASUREMENT_ID=
-NEXT_PUBLIC_GOOGLE_DRIVE_CLIENT_ID=
-NEXT_PUBLIC_PLANTUML_SERVER_URL=
-NEXT_PUBLIC_POSTHOG_KEY=
-```
-
-## Backend Variables
-
-These variables are used only by the server-side code, at runtime. Define them before running the nextjs local server (in development or
-cloud deployment), or pass them to Docker (--env-file or -e) when starting the container.
-
-### Database
-
-To enable Chat Link Sharing, you need to connect the backend to a database. We currently support Postgres and MongoDB.
-
-For Database configuration see [deploy-database.md](deploy-database.md).
-
-### LLMs
-
-The following variables when set will enable the corresponding LLMs on the server-side, without
-requiring the user to enter an API key
-
-| Variable                    | Description                                                                                                    | Required                                                          |
-|-----------------------------|----------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------|
-| `OPENAI_API_KEY`            | API key for OpenAI                                                                                             | Recommended                                                       |
-| `OPENAI_API_HOST`           | Changes the backend host for the OpenAI vendor, to enable platforms such as Helicone and CloudFlare AI Gateway | Optional                                                          |
-| `OPENAI_API_ORG_ID`         | Sets the "OpenAI-Organization" header field to support organization users                                      | Optional                                                          |
-| `ALIBABA_API_HOST`          | The Alibaba AI OpenAI-compatible endpoint                                                                      | Optional                                                          |
-| `ALIBABA_API_KEY`           | The API key for Alibaba AI                                                                                     | Optional                                                          |
-| `AZURE_OPENAI_API_ENDPOINT` | Azure OpenAI endpoint - host only, without the path                                                            | Optional, but if set `AZURE_OPENAI_API_KEY` must also be set      |
-| `AZURE_OPENAI_API_KEY`      | Azure OpenAI API key, see [config-azure-openai.md](config-azure-openai.md)                                     | Optional, but if set `AZURE_OPENAI_API_ENDPOINT` must also be set |
-| `AZURE_OPENAI_DISABLE_V1`   | Disables the next-generation v1 API for GPT-5-like models (set to 'true' to disable)                          | Optional, defaults to enabled                                     |
-| `AZURE_OPENAI_API_VERSION`  | API version for traditional deployment-based endpoints                                                          | Optional, defaults to '2025-04-01-preview'                       |
-| `AZURE_DEPLOYMENTS_API_VERSION` | API version for the deployments listing endpoint                                                            | Optional, defaults to '2023-03-15-preview'                       |
-| `ANTHROPIC_API_KEY`         | The API key for Anthropic                                                                                      | Optional                                                          |
-| `ANTHROPIC_API_HOST`        | Changes the backend host for the Anthropic vendor, for proxies or custom endpoints                             | Optional                                                          |
-| `BEDROCK_BEARER_TOKEN`      | Bedrock long-term API key (`ABSK...`). Takes priority over IAM credentials. Short-term keys only work for runtime, not model listing | Optional                                                          |
-| `BEDROCK_ACCESS_KEY_ID`     | AWS IAM Access Key ID for Bedrock (Claude models via AWS)                                                      | Optional, but if set `BEDROCK_SECRET_ACCESS_KEY` must also be set  |
-| `BEDROCK_SECRET_ACCESS_KEY` | AWS IAM Secret Access Key for Bedrock                                                                          | Optional, but if set `BEDROCK_ACCESS_KEY_ID` must also be set      |
-| `BEDROCK_SESSION_TOKEN`     | AWS Session Token for temporary/STS credentials                                                                | Optional                                                          |
-| `BEDROCK_REGION`            | AWS region for Bedrock (e.g., `us-east-1`, `us-west-2`, `eu-west-1`)                                          | Optional, defaults to `us-east-1`                                 |
-| `DEEPSEEK_API_KEY`          | The API key for Deepseek AI                                                                                    | Optional                                                          |
-| `GEMINI_API_KEY`            | The API key for Google AI's Gemini                                                                             | Optional                                                          |
-| `GROQ_API_KEY`              | The API key for Groq Cloud                                                                                     | Optional                                                          |
-| `LOCALAI_API_HOST`          | Sets the URL of the LocalAI server, or defaults to http://127.0.0.1:8080                                       | Optional                                                          |
-| `LOCALAI_API_KEY`           | The (Optional) API key for LocalAI                                                                             | Optional                                                          |
-| `MISTRAL_API_KEY`           | The API key for Mistral                                                                                        | Optional                                                          |
-| `MOONSHOT_API_KEY`          | The API key for Moonshot AI                                                                                    | Optional                                                          |
-| `OLLAMA_API_HOST`           | Changes the backend host for the Ollama vendor. See [config-local-ollama.md](config-local-ollama.md)           |                                                                   |
-| `OPENPIPE_API_KEY`          | The API key for OpenPipe                                                                                       | Optional                                                          |
-| `OPENROUTER_API_KEY`        | The API key for OpenRouter                                                                                     | Optional                                                          |
-| `PERPLEXITY_API_KEY`        | The API key for Perplexity                                                                                     | Optional                                                          |
-| `TOGETHERAI_API_KEY`        | The API key for Together AI                                                                                    | Optional                                                          |
-| `XAI_API_KEY`               | The API key for xAI                                                                                            | Optional                                                          |
-
-### LLM Observability: Helicone
-
-Helicone provides observability to your LLM calls. It is a paid service, with a generous free tier.
-It is currently supported for:
-
-- **Anthropic**: by setting the Helicone API key, Helicone is automatically activated
-- **OpenAI**: you also need to set `OPENAI_API_HOST` to `oai.hconeai.com`, to enable routing
-
-| Variable           | Description              |
-|--------------------|--------------------------|
-| `HELICONE_API_KEY` | The API key for Helicone |
-
-### Features
-
-Enable the app to Talk, Draw, and Google things up.
-
-| Variable                   | Description                                                                                                             |
-|:---------------------------|:------------------------------------------------------------------------------------------------------------------------|
-| **Text-To-Speech**         | ElevenLabs, Inworld, OpenAI TTS, LocalAI, and browser Web Speech API are supported                                      |
-| `ELEVENLABS_API_KEY`       | ElevenLabs API Key - used for calls, etc.                                                                               |
-| `ELEVENLABS_API_HOST`      | Custom host for ElevenLabs                                                                                              |
-| `ELEVENLABS_VOICE_ID`      | Default voice ID for ElevenLabs                                                                                         |
-|                            | *Note: OpenAI TTS and LocalAI TTS reuse credentials from your configured LLM services (no separate env vars needed)*   |
-| **Google Custom Search**   | [Google Programmable Search Engine](https://programmablesearchengine.google.com/about/)  produces links to pages        |
-| `GOOGLE_CLOUD_API_KEY`     | Google Cloud API Key, used with the '/react' command - [Link to GCP](https://console.cloud.google.com/apis/credentials) |
-| `GOOGLE_CSE_ID`            | Google Custom/Programmable Search Engine ID - [Link to PSE](https://programmablesearchengine.google.com/)               |
-| **Browse**                 |                                                                                                                         |
-| `PUPPETEER_WSS_ENDPOINT`   | Puppeteer WebSocket endpoint - used for browsing (pade downloadeing), etc.                                              |
-| **Backend**                |                                                                                                                         |
-| `HTTP_BASIC_AUTH_USERNAME` | See the [Authentication](deploy-authentication.md) guide. Username for HTTP Basic Authentication.                       |
-| `HTTP_BASIC_AUTH_PASSWORD` | Password for HTTP Basic Authentication.                                                                                 |
-
-### Frontend Variables
-
-The value of these variables are passed to the frontend (Web UI) - make sure they do not contain secrets.
-
-| Variable                          | Description                                                                                                                                                                                                                                     |
-|:----------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `NEXT_PUBLIC_DEBUG_BREAKS`        | (optional, development) When set to 'true', enables automatic debugger breaks on DEV/error/critical logs in development builds                                                                                                                  |
-| `NEXT_PUBLIC_MOTD`                | Message of the Day - displays a dismissible banner at the top of the app (see [customizations](customizations.md) for the template variables). Example: 🔔 Welcome to our deployment! Version {{app_build_pkgver}} built on {{app_build_time}}. |
-| `NEXT_PUBLIC_GA4_MEASUREMENT_ID`  | (optional) The measurement ID for Google Analytics 4. (see [deploy-analytics](deploy-analytics.md))                                                                                                                                             |
-| `NEXT_PUBLIC_GOOGLE_DRIVE_CLIENT_ID` | (optional) Google OAuth Client ID for Drive Picker. Can reuse `AUTH_GOOGLE_ID`. See [Google Drive](config-feature-google-drive.md)                                                                                                          |
-| `NEXT_PUBLIC_PLANTUML_SERVER_URL` | The URL of the PlantUML server, used for rendering UML diagrams. Allows using custom local servers.                                                                                                                                             |
-| `NEXT_PUBLIC_POSTHOG_KEY`         | (optional) Key for PostHog analytics. (see [deploy-analytics](deploy-analytics.md))                                                                                                                                                             |
-
-> Important: these variables must be set at build time, which is required by Next.js to pass them to the frontend.
-> This is in contrast to the backend variables, which can be set when starting the local server/container.
-
----
-
-For a higher level overview of backend code and environment customization,
-see the [big-AGI Customization](customizations.md) guide.

docs/help-advanced-tricks.md

@@ -1,46 +0,0 @@
----
-unlisted: true
----
-
-# Big-AGI Advanced Tips & Tricks
-
-> 🚨 This file is not meant for publication, and it's just been created as a handbook with tips
-> and tricks to make Big-AGI more efficient and productive. 🚨
-
-Welcome to the advanced tips and tricks guide for Big-AGI. This document will help you make the most of the platform's existing features.
-
----
-
-## Hidden Gems
-
-- **Shift + Double-Click** on a chat message to **edit** it.
-- **Shift + Trash Icon** to **delete** a chats and messages without confirmation.
-  - also applies elsewhere: delete Attachments, etc.
-- **Shift + Click** on **New Chat** to create an incognito chat.
-- Drag a big-AGI saved chat into Big-AGI to load (or attach) it.
-
-## Not-so-obvious Shortcuts
-
-- When sending a message:
-  - Enter is for newlines
-  - **Shift + Enter** to send the message.
-  - **Ctrl + Enter** to **Beam** the message.
-  - **Alt/Option + Enter** to send the message without an answer.
-- When editing a message:
-  - **Ctrl + Enter** to **Save** the changes.
-  - **Shift + Ctrl + Enter** to **Save & Regenerate**.
-- Scroll between messages:
-  - **Ctrl + Up/Down** to scroll between **messages** and/or **Beams**.
-  
-## Worth the Effort:
-
-- [LiveFile](help-feature-livefile.md) works on **Chrome**: Pair and synchronize your documents and code blocks with files on your local system: refresh, save, update them.
-
-## Best User Hacks:
-
-- 
-
----
-
-Note: this document is just at the beginning. It's here so we can capture
-the best tips over time.

docs/help-data-ownership.md

@@ -1,126 +0,0 @@
-# Big-AGI Data Ownership Guide
-
-Big-AGI is a **client-first** web application, which means it prioritizes speed and data ownership compared to cloud apps.
-Your *API keys*, *chat history*, and *settings* live in your
-browser's [local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage), not
-on cloud servers.
-
-You can use Big-AGI in two ways:
-
-1. Run it yourself (open-source)
-2. Use big-agi.com (hosted service)
-
-This guide explains how the open-source version handles your data. You can verify everything in [the source code](https://github.com/enricoros/big-agi).
-
-## Client-Side Storage
-
-Within Big-AGI almost all chat/keys data is handled client-side in your browser using two
-standard browser storage mechanisms:
-
-- **Local Storage**: API keys, settings, and configurations ([learn more](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
-- **IndexedDB**: Chat history and larger files ([learn more](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API))
-
-The Big-AGI backend mainly passes requests to AI services (OpenAI, Anthropic, etc.). It doesn't store your data, except for the chat-sharing function if used.
-
-You can see your data in your browser's local storage and IndexedDB - try it yourself:
-
-1. In Chrome: Open DevTools (press F12 on Windows, ⌘ + ⌥ + I on Mac)
-2. Click 'Application' > 'Local Storage'
-3. See your settings and API keys
-
-![Browser local storage showing API keys and chat data](pixels/data_ownership_local_storage.png)
-
-### Sync for Authenticated Users
-
-Users with accounts on big-agi.com who opt into Sync (a Pro feature) have their entity data - such as conversations and personas - replicated to the server for multi-device access.
-Server-side data is isolated per-user using Row Level Security (RLS), ensuring that no other user can access your synced data.
-Sync is entirely optional; without it, all data remains local to your browser.
-
-### What This Means For You
-
-Storing data in your browser means:
-
-- Your data stays on **one device/browser only**
-- Clearing browser data **erases your chats** - make backups
-- Anyone using your browser can see your chats and keys
-- Running your own server needs technical skills
-
-### Local Device Identifier
-
-Big-AGI generates a _device identifier_ that combines timestamp and random components, stored only on your device. This identifier:
-
-- Is used only for the **optional sync functionality** between your devices
-- Helps maintain data consistency when using Big-AGI across multiple devices
-- Remains completely local unless you explicitly enable sync
-- Is not used for tracking, analytics, or telemetry
-- Can be deleted anytime by clearing local storage
-- Is fully transparent - see the implementation in `src/common/stores/store-client.ts`
-
-## How Data Flows
-
-AI interactions in Big-AGI, such as chats, AI titles, text to speech, browsing, flow through three components:
-
-1. **Browser** (client/installed App) - Stores your keys & data locally
-2. **Backend** (routing server) - Passes requests to AI services
-3. **AI Services** - Where the actual AI processing happens
-
-### Self-Deployed Version: Your Infrastructure
-
-You run the server. Your data only leaves when making AI requests.
-The keys and chats are under your control and pass through your code, and are sent to
-the upstream AI services on a per-request basis.
-
-![data_ownership_local.png](pixels/data_ownership_deployed.png)
-
-### Web Version: Using big-agi.com
-
-Your data passes through the hosted Big-AGI edge network to reach AI services. The keys
-and chats pass through Big-AGI's edge network to reach the AI services on a per-request basis,
-and then are send to the upstream AI services.
-
-![data_ownership_hosted.png](pixels/data_ownership_hosted.png)
-
-### Direct Connection (Browser → AI Service)
-
-Most AI services offer a **Direct Connection** toggle (under a service's Advanced settings). When enabled, the browser calls the AI provider's API directly, skipping the Big-AGI server entirely.
-
-Benefits:
-
-- **No 4.5 MB upload limit** - the Vercel body-size cap does not apply, so larger attachments and long prompts go through.
-- **No 300-second timeout** - the Vercel function timeout does not apply, so long-running generations keep streaming.
-- **More privacy** - connection metadata (IP, timestamp, edge region, Vercel telemetry) is not observable by the Big-AGI edge server.
-
-Tradeoff:
-
-- **Slightly more downlink bandwidth**: when traffic passes through the Big-AGI edge, repetitive streaming frames are compacted; direct streams arrive verbatim from the provider.
-
-Availability requires both:
-
-1. The API key is set in your browser (client-side), not via server environment variables. Server-key deployments cannot use Direct Connection because the browser has no credential to send.
-2. The AI service allows CORS (browser-origin requests). Most major providers do; Big-AGI sets any extra headers they require.
-
-Direct Connection is a net win on speed, limits, and privacy whenever the provider permits it.
-
-## Security Best Practices
-
-**Basic Security**:
-
-- **Never share API keys**
-- **Don't use shared computers**
-- Use private browsing for one-off sessions
-- Use trusted networks
-- Back up your data
-
-**When Running Your Own Server**:
-
-- Use [environment variables](environment-variables.md) for API keys
-- Run on trusted infrastructure
-- Keep your installation updated
-
-## TL;DR
-
-Your API keys and chats stay in your browser. The server only passes requests to AI services.
-
-Use big-agi.com for convenience, or [run it yourself](installation.md) for full control.
-
-Need help? Join our [Discord](https://discord.gg/MkH4qj2Jp9) or open a [GitHub issue](https://github.com/enricoros/big-agi/issues).

docs/help-faq.md

@@ -1,48 +0,0 @@
-# Frequently Asked Questions
-
-Quick answers to common questions about Big-AGI. For detailed documentation, see our [Website Docs](https://big-agi.com/docs).
-
-### Connectivity
-
-<details open>
-<summary><b>What is "Direct Connection" and should I enable it?</b></summary>
-
-Direct Connection lets the browser call the AI provider's API directly, skipping the Big-AGI edge server. It appears as a toggle in each AI service's Advanced settings when your API key is set client-side.
-
-**When available, it is a net win**: faster, fewer restrictions, more privacy.
-
-- **No 4.5 MB upload limit** (Vercel body-size cap does not apply).
-- **No 300-second timeout** (Vercel function timeout does not apply; call length is bound only by the AI service).
-- **More privacy** - connection metadata (IP, timestamp, edge region, Vercel telemetry) is not observable by the Big-AGI edge server.
-- **Slightly more downlink bandwidth** - when passing through the edge, Big-AGI sheds repetitive streaming frames; direct streams arrive verbatim.
-
-**When it is unavailable**:
-
-1. **Server-side keys** - if the deployment stores API keys in server environment variables, the browser has no credential to send directly.
-2. **Provider does not allow CORS** - browsers cannot call APIs that block cross-origin requests. Most major providers permit it; Big-AGI sets any required headers.
-</details>
-
-### Versions
-
-<details open>
-<summary><b>How do I check my Big-AGI version?</b></summary>
-
-You can see the version in the _News_ section of the app, as per the image below.
-
-![Version location in Big-AGI](https://github.com/user-attachments/assets/cd295094-0114-420f-a5b9-0d762e59b506)
-</details>
-
-<details open>
-<summary><b>How do I verify my Vercel deployment version?</b></summary>
-
-You can go in the **deployments** section of your Vercel project, and at a quick glance see
-what is the latest deployment status, time, and link to the source code.
-
-![Vercel deployments view](https://github.com/user-attachments/assets/664b8c3d-496e-4595-ad5e-898bdb82507c)
-
-Each deployment links directly to its source code commit.
-</details>
-
----
-
-Missing something? [Open an issue](https://github.com/enricoros/big-agi/issues/new) or [join our Discord](https://discord.gg/MkH4qj2Jp9).

docs/help-feature-livefile.md

@@ -1,167 +0,0 @@
-# LiveFile: Synchronize Your Documents with Local Files
-
-## Introduction
-
-**LiveFile** is a powerful feature in big-AGI that allows you to **pair and synchronize
-your documents and code blocks** with files on your local system.
-
-This feature enables a **two-way connection between big-AGI and your local files on disk**,
-saving you time and effort.
-
-With LiveFile, you can:
-
-- **Pair** documents and code blocks with local files.
-- **Monitor** changes in local files and update content in big-AGI.
-- **Refresh** chat attachments with the latest content.
-- **Save** edits made in big-AGI back to your local files.
-- **Store** AI-generated code and content.
-
----
-
-## Requirements
-
-- **Supported Browsers:**
-  - **Google Chrome** (desktop)
-  - **Microsoft Edge** (desktop)
-- **Operating Systems:**
-  - **Desktop platforms only**
-  - **Note:** Mobile devices (iOS and Android) are **not supported** due to browser limitations.
-- **File Types:**
-  - Designed for **text-based files** (e.g., `.txt`, `.md`, `.js`, `.py`).
-- **Performance:**
-  - Can handle **dozens of files efficiently**.
-- **Limitations:**
-  - **File Size Limit**: 
-    - Supports text files up to **10 MB**.
-  - **Pairing Persistence:**
-    - LiveFile connections **do not persist across sessions**.
-    - After reloading the page, you will need to re-pair your files.
-  - **Saving Overwrites:**
-    - Saving changes in big-AGI will **overwrite the entire file**.
-    - Use external tools for version control or incremental backups.
-
----
-
-## Enabling LiveFile
-
-LiveFile can be enabled automatically or manually in your Big-AGI workflow.
-
-### Automatic Pairing
-
-When you:
-
-- **Attach**, **drop**, or **paste** a file into a chat message,
-
-LiveFile is **automatically enabled** for that attachment. This means you can start
-monitoring and reloading changes without any additional setup.
-
-### Manual Pairing
-
-For existing attachments or code blocks that:
-
-- **Do not have LiveFile enabled** (e.g., created on other devices),
-- **Are AI-generated code snippets without an associated file**,
-
-You can manually pair them with a local file.
-
-#### Pairing Attachments
-
-1. **Select the Attachment:**
-  - Click on the attachment in the chat to view it in the previewer.
-
-2. **Initiate Pairing:**
-  - Click on **"Pair File"** (🔗).
-  - If you have open LiveFiles, they will be listed for easy selection.
-  - Alternatively, you can select a new file from your local system.
-
-3. **Grant Permissions**
-  - When prompted, allow big-AGI to access the file.
-
-#### Pairing Code Blocks
-
-1. **Access Code Block Options:**
-  - Click on the code block to reveal the header with options.
-
-2. **Initiate Pairing:**
-  - Click the **"Pair File"** button (🔗).
-  - Select from your open LiveFiles or choose a new file.
-
-3. **Confirm Pairing:**
-  - Grant permission when prompted.
-
----
-
-## Using LiveFile
-
-### Monitoring Changes
-
-- **Automatic Monitoring:**
-  - LiveFile watches for changes in your paired local files.
-  - If the file is modified outside of big-AGI, you'll be shown the changes in the LiveFile bar.
-  - There is also a **"Replace with File"** option to manually load the latest content and see the changes.
-
-- **Refreshing Content:**
-  - Click **"Replace with File"** (🔄) to load the latest content from the paired file into big-AGI.
-
-### Saving Edits Back to Paired Files
-
-- **Editing Attachments or Code Blocks:**
-  - Modify the content directly within big-AGI.
-  - Attachments: Click on the attachment to open the previewer and click on "Edit" to make changes.
-  - Code Blocks: Select "Edit" on the chat message to update code blocks.
-
-- **Saving Changes:**
-  - Click **"Save to File"** (💾) to overwrite the local file with your changes.
-  - **Note:** This action overwrites the entire file. Ensure this is what you want before proceeding.
-
----
-
-## Best Practices
-
-- **Monitor External Changes:**
-  - Refresh content in big-AGI if the local file has been modified outside the application.
-
-- **Use a Version Control System:**
-  - For critical files, consider using Git or other version control systems to track and monitor changes, authorship, and history.
-
----
-
-## Troubleshooting
-
-- **LiveFile Options Not Visible:**
-  - Ensure you are using a **supported desktop browser**.
-  - Check that you have the latest version of big-AGI.
-
-- **Permission Issues:**
-  - Confirm that you granted big-AGI permission to access your files.
-  - Check your browser's settings to ensure file access is allowed.
-
----
-
-## Technical Details
-
-LiveFile uses the [File System Access API](https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API) to 
-interact with your local files securely. It leverages the [browser-fs-access](https://github.com/GoogleChromeLabs/browser-fs-access) library, 
-an open-source project by Google Chrome Labs, which provides an easy interface to the File System Access API with fallbacks for broader browser support.
-
-- **Security:**
-  - Access to files requires explicit user permission.
-
-- **Performance:** 
-  - Designed to handle dozens of files efficiently (tested on hundreds).
-  - Works with the Big-AGI attachment system to recursively add directories.
-
-- **Browser Support:**
-  - Fully supported on **Google Chrome** and **Microsoft Edge** desktop versions.
-
----
-
-## Another Big-AGI First!
-
-You can significantly boost your productivity and streamline your workflow within big-AGI
-by understanding how to utilize LiveFile's features fully.
-
-This Feature is in Beta as there are a few limitations and improvements to be made. 
-Join us in enjoying and enhancing this feature on [big-AGI.com](https://big-agi.com), or
-[GitHub](https://github.com/enricoros/big-AGI) for support and [Discord](https://discord.gg/MkH4qj2Jp9)
-to share the love.

docs/help-feature-microphone.md

@@ -1,141 +0,0 @@
-# Enabling Microphone Access for Speech Recognition
-
-This guide explains how to enable microphone access for speech recognition in various browsers and mobile devices.
-Ensuring microphone access is essential for using voice features in applications like big-AGI.
-
-## Desktop Browsers
-
-### Google Chrome (All Platforms, recommended)
-
-1. Open the website (e.g., big-AGI) in Chrome.
-2. Click the **lock icon** in the address bar.
-3. In the dropdown, find **"Microphone"**.
-   - Set it to **"Allow"**.
-4. If "Microphone" isn't listed:
-   - Click on **"Site settings"**.
-   - Find **"Microphone"** in the permissions list.
-   - Change the setting to **"Allow"**.
-5. **Refresh** the page.
-
-### Safari (macOS)
-
-**[Watch the video tutorial: How to enable Speech Recognition in Safari](https://vimeo.com/1010342201)**
-
-If you're seeing a "Speech Recognition permission denied" error, follow these steps:
-
-1. Open **System Settings**.
-   - Go to **Privacy & Security** > **Speech Recognition**.
-   - Enable Safari in the list of allowed applications.
-   - Quit & Open Safari.
-2. Click **Safari** in the top menu bar.
-   - Select **Settings**.
-   - Go to the **Websites** tab.
-   - Select **Microphone** from the sidebar.
-   - Find big-AGI (or localhost for developers) in the list and set it to **Allow**.
-   - Close the Settings window.
-3. **Refresh** the page.
-
-This quick and simple fix should get essential voice input working in big-AGI on your Mac.
-
-### Microsoft Edge (Windows)
-
-1. Open the website in Edge.
-2. Click the **lock icon** in the address bar.
-3. Click **"Permissions for this site"**.
-4. Find **"Microphone"**.
-   - Set it to **"Allow"**.
-5. **Refresh** the page.
-
-### Firefox (All Platforms)
-
-> **Note:** The Speech Recognition API is **not supported** in Firefox. If you're using Firefox, please switch to a supported browser to use speech recognition
-> features.
-
-## Mobile Devices
-
-### Android (Chrome)
-
-1. Open the website in Chrome.
-2. Tap the **lock icon** in the address bar.
-3. Tap **"Permissions"**.
-4. Find **"Microphone"**.
-   - Set it to **"Allow"**.
-5. **Refresh** the page.
-
-### iOS (Safari)
-
-1. Open the **Settings** app on your device.
-2. Scroll down and tap **"Safari"**.
-3. Tap **"Microphone"**.
-4. Ensure **"Ask"** or **"Allow"** is selected.
-5. Return to Safari and open the website.
-6. If prompted, allow microphone access.
-7. **Refresh** the page.
-
-### iOS (Chrome)
-
-> **Note:** Chrome on iOS uses Safari's engine due to system limitations. Microphone permissions are managed through iOS settings.
-
-1. Open the **Settings** app.
-2. Scroll down and tap **"Chrome"**.
-3. Ensure **"Microphone"** is toggled **on**.
-4. Open Chrome and navigate to the website.
-5. If prompted, allow microphone access.
-6. **Refresh** the page.
-
-## Troubleshooting
-
-If you're still experiencing issues after enabling microphone access:
-
-**Check System Permissions (macOS):**
-
-- Open **System Settings**.
-- Go to **"Privacy & Security"**.
-- Select the **"Privacy"** tab.
-- Click **"Microphone"** in the sidebar.
-- Ensure your browser (e.g., Chrome, Safari) is checked.
-- You may need to unlock the settings by clicking the lock icon at the bottom.
-
-**Check Microphone Access (Windows):**
-
-- Open **Settings**.
-- Go to **"Privacy"** > **"Microphone"**.
-- Ensure **"Allow apps to access your microphone"** is **on**.
-- Scroll down and make sure your browser is allowed.
-
-**Close Other Applications:**
-
-- Close any applications that might be using the microphone.
-
-**Restart the Browser:**
-
-- Close all browser windows and reopen.
-
-**Update Your Browser:**
-
-- Ensure you're using the latest version.
-
-**Check for Browser Extensions:**
-
-- Disable extensions that might block access to the microphone.
-
-For persistent issues, consult your browser's official support resources or contact big-AGI support.
-
-## Technical Details
-
-Big-AGI uses the [Web Speech API (SpeechRecognition)](https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognition)
-to transcribe spoken words into text. This API provides real-time transcription with live previews and works on most
-modern mobile and desktop browsers.
-
-**Note on Browser Support:**
-
-| Browser        | Support Level   | Notes                                                                  |
-|----------------|-----------------|------------------------------------------------------------------------|
-| Google Chrome  | ✅ Recommended   | Fully supported on desktop and Android. Preferred for best experience. |
-| Safari         | ✅ Supported     | Requires macOS/iOS 14 or later.                                        |
-| Microsoft Edge | ✅ Supported     | Fully supported on desktop.                                            |
-| Firefox        | ❌ Not Supported | SpeechRecognition API not available.                                   |
-
-**Recommendation:**
-For the best experience with speech recognition features, we strongly recommend using Google Chrome. 
-Ensure your browser is up to date to benefit from the latest features and security updates.

docs/installation.md

@@ -1,150 +0,0 @@
-# Installation Guide
-
-Welcome to the big-AGI Installation Guide - Whether you're a developer
-eager to explore, a system integrator, or an enterprise looking for a
-white-label solution, this comprehensive guide ensures a smooth setup
-process for your own instance of big-AGI and related products.
-
-**Try big-AGI** - You don't need to install anything if you want to play with big-AGI
-and have your API keys to various model services. You can access our free instance on [big-AGI.com](https://big-agi.com).
-The free instance runs the latest `main` branch from this repository.
-
-## 🧩 Build-your-own
-
-If you want to change the code, have a deeper configuration,
-add your own models, or run your own instance, follow the steps below.
-
-### Local Development
-
-**Prerequisites:**
-
-- Node.js and npm installed on your machine.
-
-**Steps:**
-
-1. Clone the big-AGI repository:
-   ```bash
-   git clone https://github.com/enricoros/big-AGI.git
-   cd big-AGI
-   ```
-2. Install dependencies:
-   ```bash
-   npm install
-   ```
-3. Run the development server:
-   ```bash
-   npm run dev
-   ```
-   Your big-AGI instance is now running at `http://localhost:3000`.
-
-### Local Production build
-
-The production build is optimized for performance and follows
-the same steps 1 and 2 as for [local development](#local-development).
-
-3. Build the production version:
-   ```bash
-   # .. repeat the steps above up to `npm install`, then:
-   npm run build
-   ```
-4. Start the production server (`npx` may be optional):
-   ```bash
-   npx next start --port 3000
-   ```
-   Your big-AGI production instance is on `http://localhost:3000`.
-
-### Advanced Customization
-
-Want to pre-enable models, customize the interface, or deploy with username/password or alter code to your needs?
-Check out the [Customizations Guide](README.md) for detailed instructions.
-
-## ☁️ Cloud Deployment Options
-
-To deploy big-AGI on a public server, you have several options. Choose the one that best fits your needs.
-
-### Deploy on Vercel
-
-Install big-AGI on Vercel with just a few clicks.
-
-Create your GitHub fork, create a Vercel project over that fork, and deploy it. Or press the button below for convenience.
-
-[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fenricoros%2Fbig-AGI&env=OPENAI_API_KEY&envDescription=Backend%20API%20keys%2C%20optional%20and%20may%20be%20overridden%20by%20the%20UI.&envLink=https%3A%2F%2Fgithub.com%2Fenricoros%2Fbig-AGI%2Fblob%2Fmain%2Fdocs%2Fenvironment-variables.md&project-name=big-AGI)
-
-### Deploy on Cloudflare
-
-> Note: Cloudflare Pages deployment has limitations due to Edge Runtime constraints.
-> See the [Cloudflare guide](deploy-cloudflare.md) for details and known issues.
-
-### Docker Deployments
-
-Containerize your big-AGI installation using Docker for portability and scalability.
-Our [Docker Deployment Guide](deploy-docker.md) will walk you through the process,
-or follow the steps below for a quick start.
-
-1. (optional) Build the Docker image - if you do not want to use the [pre-built Docker images](https://github.com/enricoros/big-AGI/pkgs/container/big-agi):
-   ```bash
-   docker build -t big-agi .
-   ```
-2. Run the Docker container with either:
-   ```bash
-   # 2A. if you built the image yourself:
-   docker run -d -p 3000:3000 big-agi
-
-   # 2B. or use the pre-built image:
-   docker run -d -p 3000:3000 ghcr.io/enricoros/big-agi
-
-   # 2C. or use docker-compose:
-   docker-compose up
-   ```
-   Access your big-AGI instance at `http://localhost:3000`.
-
-If you deploy big-AGI behind a reverse proxy, you may want to check out the [Reverse Proxy Configuration Guide](deploy-reverse-proxy.md).
-
-### Kubernetes Deployment
-
-Deploy big-AGI on a Kubernetes cluster for enhanced scalability and management. Follow these steps for a Kubernetes deployment:
-
-1. Clone the big-AGI repository:
-   ```bash
-   git clone https://github.com/enricoros/big-AGI.git
-   cd big-AGI
-   ```
-
-2. Configure the environment variables:
-   ```bash
-   cp docs/k8s/env-secret.yaml env-secret.yaml
-   vim env-secret.yaml  # Edit the file to set your environment variables
-   ```
-
-3. Apply the Kubernetes configurations:
-   ```bash
-   kubectl create namespace ns-big-agi
-   kubectl apply -f docs/k8s/big-agi-deployment.yaml -f env-secret.yaml
-   ```
-
-4. Verify the deployment:
-   ```bash
-   kubectl -n ns-big-agi get svc,pod,deployment
-   ```
-
-5. Access the big-AGI application:
-   ```bash
-   kubectl -n ns-big-agi port-forward service/svc-big-agi 3000:3000
-   ```
-   Your big-AGI instance is now accessible at `http://localhost:3000`.
-
-For more detailed instructions on Kubernetes deployment, including updating and troubleshooting, refer to our [Kubernetes Deployment Guide](deploy-k8s.md).
-
-## Enterprise-Grade Installation
-
-For businesses seeking a fully-managed, scalable solution, consider our managed installations.
-Enjoy all the features of big-AGI without the hassle of infrastructure management. [hello@big-agi.com](mailto:hello@big-agi.com) to learn more.
-
-## Support
-
-Join our vibrant community of developers, researchers, and AI enthusiasts. Share your projects, get help, and collaborate with others.
-
-- [Discord Community](https://discord.gg/MkH4qj2Jp9)
-- [X (Twitter)](https://x.com/enricoros)
-
-For any questions or inquiries, please don't hesitate to [reach out to our team](mailto:hello@big-agi.com).

docs/k8s/big-agi-deployment.yaml

@@ -1,52 +0,0 @@
----
-apiVersion: v1
-kind: Namespace
-metadata:
-  name: ns-big-agi
----
-apiVersion: apps/v1
-kind: Deployment
-metadata:
-  labels:
-    app: big-agi
-  name: deployment-big-agi
-  namespace: ns-big-agi
-spec:
-  replicas: 1
-  selector:
-    matchLabels:
-      app: big-agi
-  strategy: {}
-  template:
-    metadata:
-      labels:
-        app: big-agi
-    spec:
-      containers:
-        - image: ghcr.io/enricoros/big-agi:latest
-          name: big-agi
-          ports:
-            - containerPort: 3000
-          args:
-            - next
-            - start
-            - -p
-            - "3000"
-          envFrom:
-            - secretRef:
-                name: env
----
-apiVersion: v1
-kind: Service
-metadata:
-  labels:
-    app: big-agi
-  name: svc-big-agi
-  namespace: ns-big-agi
-spec:
-  ports:
-    - name: "http"
-      port: 3000
-      targetPort: 3000
-  selector:
-    app: big-agi

docs/k8s/env-secret.yaml

@@ -1,49 +0,0 @@
----
-apiVersion: v1
-kind: Secret
-metadata:
-  name: env
-  namespace: ns-big-agi
-type: Opaque
-stringData:
-  # IMPORTANT: This file contains sensitive information. Do not commit changes to version control.
-  # All variables are optional. Fill in only the ones you need.
-  #
-  # For the latest information on all the environment variables, see /docs/environment-variables.md
-  #
-
-  # LLMs
-  OPENAI_API_KEY: ""
-  OPENAI_API_HOST: ""
-  OPENAI_API_ORG_ID: ""
-  ALIBABA_API_HOST: ""
-  ALIBABA_API_KEY: ""
-  AZURE_OPENAI_API_ENDPOINT: ""
-  AZURE_OPENAI_API_KEY: ""
-  ANTHROPIC_API_KEY: ""
-  ANTHROPIC_API_HOST: ""
-  DEEPSEEK_API_KEY: ""
-  GEMINI_API_KEY: ""
-  GROQ_API_KEY: ""
-  LOCALAI_API_HOST: ""
-  LOCALAI_API_KEY: ""
-  MISTRAL_API_KEY: ""
-  MOONSHOT_API_KEY: ""
-  OLLAMA_API_HOST: ""
-  OPENPIPE_API_KEY: ""
-  OPENROUTER_API_KEY: ""
-  PERPLEXITY_API_KEY: ""
-  TOGETHERAI_API_KEY: ""
-  XAI_API_KEY: ""
-
-  # Browse
-  PUPPETEER_WSS_ENDPOINT: ""
-
-  # Search
-  GOOGLE_CLOUD_API_KEY: ""
-  GOOGLE_CSE_ID: ""
-
-  # Text-To-Speech: Eleven Labs
-  ELEVENLABS_API_KEY: ""
-  ELEVENLABS_API_HOST: ""
-  ELEVENLABS_VOICE_ID: ""