Skip to content

yym68686/Cerebr

Repository files navigation

Chrome Web Store

English | Simplified Chinese

🧠 Cerebr - Intelligent AI Assistant

screenshot

The name "Cerebr" comes from a Latin root related to "brain" or "cerebrum". This etymology reflects our vision: to integrate powerful AI capabilities from Claude, OpenAI, and others, making Cerebr your second brain for deep reading and understanding. Cerebr is a powerful Chrome browser AI assistant extension focused on enhancing your work efficiency and learning experience.

Born from a need for a clean, efficient browser AI assistant, Cerebr stands out with its minimalist design and powerful features. While other solutions often come with limitations or cluttered interfaces, Cerebr focuses on delivering a seamless, distraction-free experience for your web browsing needs.

✨ Core Features

  • 🎯 Smart Sidebar - Quick access via hotkey (Windows: Alt+Z / Mac: Ctrl+Z) to chat with AI anytime, anywhere
  • 🔄 Multiple API Support - Configure multiple APIs to flexibly switch between different AI assistants
  • 📝 Comprehensive Q&A - Support webpage content Q&A, PDF document Q&A, image Q&A and more
  • 🎨 Elegant Rendering - Perfect support for Markdown text rendering and LaTeX math formula display
  • Real-time Response - Stream output for instant AI replies
  • 🌓 Theme Switching - Support light/dark themes to protect your eyes
  • 🌐 Web Version - Support web version, no installation required, accessable from any browser, support vercel, GitHub Pages and cloudflare pages deployment

🛠️ Technical Features

  • 💾 State Persistence - Automatically save chat history, sidebar status, etc.
  • 🔍 Smart Extraction - Automatically identify and extract webpage/PDF content
  • ⌨️ Shortcut Operations - Support hotkey to clear chat (Windows: Alt+X / Mac: Ctrl+X), up/down keys for quick history recall
  • 🔒 Secure & Reliable - Support multiple API key management with local data storage
  • 🎭 High Compatibility - Support mainstream browsers, adapt to various webpage environments

🎮 User Guide

  1. 🔑 Configure API

    • Click the settings button
    • Fill in API Key, Base URL and model name
    • Support adding multiple API configurations
  2. 💬 Start Chatting

    • Use hotkey Windows: Alt+Z / Mac: Ctrl+Z to summon sidebar
    • Input questions and send
    • Support image upload for visual Q&A
  3. 📚 Webpage/PDF Q&A

    • Enable webpage Q&A switch
    • Automatically identify and extract current page content
    • Support intelligent PDF file Q&A

🔧 Advanced Features

  • 📋 Right-click Copy - Support right-click to directly copy message text
  • 🔄 History Records - Use up/down arrow keys to quickly recall historical questions
  • 🖼️ Image Preview - Click images to view full size
  • ⚙️ Custom Settings - Support customizing hotkeys, themes and more

🚀 Web Version Deploy

  1. You can quickly deploy the web version of Cerebr to Vercel with one click:

Deploy with Vercel

  1. You can deploy to Cloudflare Pages:
# Install Wrangler CLI
npm install -g wrangler

# Login to Cloudflare
wrangler login

# Deploy to Cloudflare Pages with SSL configuration
wrangler pages deploy . --project-name cerebr --branch main
  1. You can also deploy to GitHub Pages:
# Fork this repository
# Then go to your repository's Settings -> Pages
# In the "Build and deployment" section:
# - Select "Deploy from a branch" as Source
# - Choose your branch (main/master) and root (/) folder
# - Click Save

The deployment will be automatically handled by GitHub Actions. You can access your site at https://<your-username>.github.io/cerebr

Web Version Features

  • 🌐 Access Cerebr from any browser without installation
  • 💻 Same powerful features as the Chrome extension
  • ☁️ Deploy your own instance for better control
  • 🔒 Secure and private deployment

🚀 Latest Updates

  • 🆕 Added image Q&A functionality
  • 🔄 Optimized webpage content extraction algorithm
  • 🐛 Fixed math formula rendering issues
  • ⚡ Improved overall performance and stability

📝 Development Notes

This project is developed using Chrome Extension Manifest V3, with main tech stack:

  • 🎨 Native JavaScript + CSS
  • 📦 Chrome Extension API
  • 🔧 PDF.js + KaTeX + Marked.js

🤝 Contribution Guide

Welcome to submit Issues and Pull Requests to help improve the project. Before submitting, please ensure:

  • 🔍 You have searched related issues
  • ✅ Follow existing code style
  • 📝 Provide clear description and reproduction steps

📄 License

This project is licensed under the MIT License