BrainDrive v0.6.5 Release Notes

🚀 Features & Enhancements

• #209 Add white-label settings for customizable branding links

  • Introduced white_label_settings to support branding customization via settings.
  • Backend initializer and updater ensure presence for new and existing users.
  • Frontend now dynamically loads footer links (e.g., Documentation, Community) from the settings service.
  • Improves flexibility for OEM/rebranding scenarios.

• #208 Improve plugin installation UX

  • Added clearer flows, registry refresh enhancements, and support for plugin install timeouts (VITE_PLUGIN_INSTALL_TIMEOUT).

• #207 Rich document format ingestion

  • Layout-aware extraction from PDF, DOCX, PPTX, HTML/Markdown, EPUB, ODT, RTF.

• #205 Context upload API

  • Backend support to inject structured context into assistant sessions.

• #204, #202 Persona architecture improvements

  • Backend persona handling and structure refined for better extensibility.

• #203 App info surfacing

  • Build/runtime info surfaced in UI for debugging and transparency.

• #201 Personas/Plugin Installer/Plugin Studio UX polish

  • Selection persistence, tabbed installs, better datetime formatting.

• #200 UI visual refinements

  • General visual improvements across the interface.

• #199 Background job system

  • Foundation for async operations (e.g., Ollama model installs) with /tasks dashboard.

• #194 Plugin Studio Canvas overhaul

  • Zoom controls, auto-fit, studio layout syncing.

• #176 OpenRouter provider support update

---

🛠️ Stability & Reliability

• #196 Fix React key and hook warnings in UnifiedPageRenderer.
• #193 Ensure correct persona param mapping for Ollama API.
• #161 Fix plugin repo env var decryption.
• #141 Bug fixes for provider endpoints.
• #137 Idempotent Docker service install logic.
• #133 Encrypt model endpoint reliability.
• #122 Data encryption fix.
• #114 Add Docker restart improvements and conditional rebuild.
• #110–#104 Install stability improvements and macOS compatibility.
• #103 Clean up deprecated plugin sample files.

---

📚 Documentation & Housekeeping

• #191, #183, #182 Docs folder restore, general cleanup, and design updates.
• #179, #177 .gitignore and doc housekeeping.
• #148–#146 Roadmap updates and plugin usage guide.
• #140–#129 README updates and developer quickstarts.
• #127, #126 Testing and install documentation.
• #84, #82 INSTALL guide fixes and dark-mode logo patch.

---

⬆️ Upgrade Notes

• Reinstall backend dependencies to enable new document parsing:

  pip install -r backend/requirements.txt

• Plugin install timeout is now configurable with:

  VITE_PLUGIN_INSTALL_TIMEOUT=120000

---

💡 Usage Callouts

• White-label Settings
  Admins or integrators can customize branding links (e.g., Docs, Community, Support) via the new white_label_settings. These appear dynamically in the footer and can be scoped by user or system.

• Job Dashboard
  Visit /tasks to monitor background operations like model installs.

• Document Ingestion Upgrade
  Richer format handling improves AI document comprehension.

• Context Upload API
  Inject dynamic context into assistant sessions to tailor responses.

BrainDrive Core v0.6.0

🚀 BrainDrive Core v0.6.0 Release Notes

Overview

This release represents a major step forward from v0.4.5 (July 14, 2025), delivering significant new features, stability improvements, bugfixes, and developer experience upgrades.

The highlights include:

• New Unified Dynamic Page Renderer with adaptive layouts
• Expanded Plugin Service Runtime management
• Improved Plugin Studio with interaction tracking and zero-bounce rendering
• Multiple new AI provider integrations and API key handling improvements
• Backend hardening around auth, security, and environment handling

---

✨ Features

• [#81](#81) Improve Plugin Studio layout handling & default plugins
• [#80](#80) Enhance plugin service runtime with definition_id support
• [#75](#75) Collapsible plugin panels & category counts in Settings
• [#74](#74) In-memory background job system for Ollama installs w/ SSE streaming
• [#72](#72) Responsive dynamic page layout with adaptive grid & centered rendering
• [#42](#42) Plugin Services Runtime – foundation for plugin-based service orchestration
• [#41](#41) Control visibility & editing toggle for Plugin Studio
• [#40](#40) CORS & Auth hardening + dev proxy improvements
• [#37](#37) Added Groq AI provider & streamlined model selection
• [#35](#35) Hierarchical sidebar navigation system
• [#34](#34) Refactor initializers to use GitHub-based plugin installer
• [#29](#29) Unified Dynamic Page Renderer
• [#28](#28) Add Claude provider support & enhanced API key handling
• [#27](#27) OpenRouter integration
• [#26](#26) BrainDrive Settings improvements
• [#22](#22) OpenAI plugin integration
• [#21](#21) Comprehensive plugin state management system w/ DB persistence
• [#20](#20) Local plugin install
• [#19](#19) Persona system integration

---

🔧 Enhancements

• [#73](#73) Robust API key handling & environment fallbacks for AI providers
• [#71](#71) UI cleanup for Plugin Studio & bump to v0.6.0 baseline
• [#61](#61) Extended “Powered By” branding options in Settings & UI
• [#60](#60) Added “Powered By” branding to Settings & Sidebar
• [#59](#59) Reduced render bounce & general cleanup
• [#58](#58) Plugin polish
• [#50](#50) Hardened legacy module resolution for complex IDs + better dev diagnostics
• [#46](#46) Hardened Ollama provider config parsing & logging improvements
• [#45](#45) Plugin service runtime management improvements
• [#38](#38) Safe auto-save before publish in Page Management Dialog

---

🐛 Bugfixes

• [#69](#69) Ensure conversation ID emitted early in streaming responses
• [#68](#68) Eliminate dead space in Page Builder layout
• [#67](#67) Resolve page cache inconsistency on navigation
• [#39](#39) Indent issue fix
• [#23](#23) Cleanup plugin examples
• [#18](#18) Fix migration process & workflow cleanup

---

📚 Docs & Chores

• [#79](#79) Update INSTALL.md
• [#76](#76) Small change to Settings Page text
• [#70](#70) Update PLUGIN_DEVELOPER_QUICKSTART.md
• [#63](#63) Remove legacy plugins/ directory
• [#62](#62) Update example env files with latest defaults
• [#11](#11) General Settings Module & self-updating system

---

🛠️ Contributors

Thanks to everyone who contributed PRs, fixes, and improvements in this cycle.

---

⬆️ Upgrade Notes

• Run database migrations after updating (several PRs added new fields like definition_id to service runtimes).
• Clean up any old plugins/ directory remnants.
• Update your .env files to match the new examples.

BrainDrive v0.4.5 – Persona System, Unified Plugin Installer, and Migration Overhaul

🧠 BrainDrive v0.4.5 – Persona System, Unified Plugin Installer, and Migration Overhaul

Release Date: 2025-07-14
Version: 0.4.5

---

🚀 Highlights

This release introduces powerful new features and critical backend improvements:

• ✅ Persona System for reusable, customizable AI behavior
• ✅ Unified Plugin Installer with support for GitHub & local uploads
• ✅ Safe Alembic Migration Chain with validation tooling & CI support

---

🧩 Persona System Integration

Define AI behavior profiles and seamlessly reuse them across conversations.

🔧 Backend Features

• Full CRUD API:
  GET /personas, POST /personas, PUT /personas/{id}, DELETE /personas/{id}, etc.
• Enhancements to chat_completion():
  • Inject system prompt from persona
  • Apply custom model settings
  • Link conversation metadata to persona
• Sample greeting support on conversation start
• New endpoints:
  • GET /conversations/by-persona/{id}
  • PUT /conversations/{id}/persona
  • GET /conversations/{id}/with-persona

🖥️ Frontend

• New route: /personas
• Pages:
  • PersonasPage (Grid view)
  • PersonaFormPage (Create/Edit)
• Components:
  • PersonaCard, PersonaForm, DeleteConfirmationDialog
• Hook: usePersonas for data management
• Navigation auto-updated via migration

🧪 Validated

• Persona-based prompt injection in chat
• Sample greetings
• UI tests for persona management

---

🔌 Unified Plugin Installer

Seamless plugin installation via GitHub repo or local file upload.

⚙️ Backend

• New endpoint:
  POST /api/v1/plugins/install (method = github | local-file)
• Supports:
  • GitHub repo cloning or release/tag download
  • Archive upload (.zip, .tar.gz, .rar placeholder)
• Handles:
  • Extraction
  • Validation
  • Installation
  • Metadata indexing

🖼️ Frontend

• InstallMethodTabs UI with:
  • GitHub Install
  • Local File Upload (drag-and-drop)
• FileUploadZone component with:
  • Format detection
  • File size validation
  • Upload previews
• Visual progress flow & dynamic step control

🧪 Validated

• GitHub installs from repo and tag
• ZIP/TAR file installs
• Size/format error handling

---

🛠️ Alembic Migration Chain Fix & Tooling

Critical refactor to prevent migration corruption and improve dev confidence.

🧱 Safe Migrations

• Wrapped all upgrade() / downgrade() logic with conditional checks
• Prevents duplicate index/table/column creation
• Repaired broken or missing Alembic down_revision links

🧰 Tooling & CI Support

• New CLI support:
  • Makefile
  • migrate.bat for Windows
• New scripts:
  • validate_migrations.py
  • test_migrations.py
  • migration_monitor.py
  • migration_recovery.py
• Pre-commit hooks:
  • Alembic file checks
  • Black / Flake8 linting
• migration_health_history.json snapshot tracking

📊 Migration Health Snapshot

v0.4.3

🧩 Add page_id Support to Conversations + Page Context Service

Summary

This PR introduces support for associating conversations with specific pages via a new page_id field, along with frontend and backend enhancements for context-aware conversation management.

🔧 Backend Changes

• Added page_id column to conversations table (with indexes)
• Updated ChatCompletionRequest, TextGenerationRequest, and ConversationBase schemas
• API support for filtering, creating, and updating conversations by page_id
• Alembic migration: add_page_id_to_conversations.py

🧠 Frontend Changes

• New PageContextService to track and share current page metadata (pageId, pageName, etc.)
• DynamicPageRenderer sets page context on load
• Registered service globally via App.tsx

BrainDrive v0.1.0

This is the initial "Build in Public" release for BrainDrive.

The goal of this release is for developers to see the direction we are headed with this project.