Why it is worth attention

It provides a playful, real-time visual feedback loop for Gemini interactions, distinguishing between user typing, AI thinking, AI typing, and completion with distinct animated states, and it is open source with a privacy-friendly design.

Who it is for

Frequent users of Google Gemini who want a more engaging interface
Chrome extension enthusiasts looking for a fun, interactive project
Developers interested in DOM-based event detection and Chrome extension patterns
People who enjoy cute desktop assistants or virtual pets

Use cases

Adding a visual indicator of AI thinking or web grounding to avoid staring at a blank screen
Making long conversations with Gemini feel more lively and responsive
Demonstrating how to build a Chrome extension that reacts to webpage state changes
Enhancing accessibility by providing non-text cues for interaction phases

Strengths

Five distinct animated states cover the full interaction cycle (waiting, typing, thinking, responding, complete)
Supports drag-and-drop repositioning anywhere on the screen
Client-side only, with a clear disclaimer that it collects no personal data
Detailed installation guide for non-technical users, including Windows and macOS paths

Considerations

Works exclusively on gemini.google.com, limiting its use to that single domain
Depends on the current DOM structure of Google Gemini, which may break if the site updates
No customization options for appearance, animation speed, or behavior are mentioned

README quick start

🌸 Gemielle - Gemini AI Assistant Widget

Gemielle là một Chrome Extension giúp hiển thị một "trợ lý AI" sinh động ở góc màn hình khi bạn sử dụng Google Gemini Web (gemini.google.com). Trợ lý sẽ tự động biểu cảm và chuyển đổi trạng thái theo thời gian thực tương ứng với hành vi của bạn và AI.

✨ Tính năng nổi bật

🎭 5 Trạng thái biểu cảm linh hoạt: Theo dõi chính xác từng bước tương tác giữa User và Gemini.
🖱️ Kéo thả tự do (Drag & Drop): Bạn có thể dễ dàng "túm" và di chuyển Gemielle đến bất kỳ góc nào trên màn hình.
⚡ Nhận diện chính xác & Mượt mà:
- Nhận diện khi user gõ prompt hoặc xoá trắng input.
- Phân biệt chính xác giữa lúc AI suy nghĩ/tìm kiếm web (Grounding) với lúc AI thực sự sinh chữ.
- Phản hồi trạng thái ngay lập tức khi AI kết thúc câu trả lời.

🎭 Các trạng thái trợ lý (Assistant States)

Trạng thái	Biểu tượng GIF	Mô tả
WAITING		Trợ lý đang ở trạng thái chờ người dùng nhập prompt.
USER_TYPING		Bạn đang gõ văn bản vào ô nhập liệu của Gemini.
AI_THINKING		AI đang suy nghĩ, xử lý yêu cầu hoặc tìm kiếm thông tin trên Web.
AI_TYPING		AI đang bắt đầu sinh và xuất văn bản trả lời.
AI_COMPLETE		AI đã hoàn thành xong câu trả lời.

🚀 Hướng dẫn cài đặt chi tiết (Dành cho người không biết code)

📌 Bước 1: Tải extension

Bấm nút Code (màu xanh ở trên cùng trang GitHub này) ➔ Chọn Download ZIP.
Giải nén tệp .zip vừa tải về, bạn sẽ nhận được thư mục chứa extension (ví dụ: Gemielle).

📌 Bước 2: Lưu trữ thư mục cài đặt

(Lưu ý: Lưu thư mục vào đúng vị trí dữ liệu tiện ích của Chrome để tránh vô tình xóa tệp khiến Extension ngưng hoạt động)

Dành cho Windows:
1. Nhấn tổ hợp phím Windows + R trên bàn phím để mở hộp thoại Run.
2. Nhập hoặc dán đường dẫn sau rồi nhấn Enter:
```
%LOCALAPPDATA%\Google\Chrome\User Data\Default\Extensions
```
3. Cửa sổ thư mục sẽ mở ra. Hãy chép (copy) thư mục Gemielle vào đây.
Dành cho macOS:
1. Mở Finder, nhấn tổ hợp phím Command + Shift + G (hoặc chọn menu Go ➔ Go to Folder...).
2. Nhập đường dẫn sau rồi nhấn Return (Enter):
```
~/Library/Application Support/Google/Chrome/Default/Extensions
```
3. Cửa sổ thư mục sẽ mở ra. Hãy *chép (copy) thư mục Gemielle

Related repositories

Similar projects matched by category, topics, and programming language.

mshumer

Featured

Claude-of-Duty

A browser-based first-person shooter built entirely with procedural generation and orchestrated AI agents, featuring 55k lines of Three.js/WebGL2 code and no art assets.

AI & Machine LearningAI Agents

1,234

gnipbao

Featured

story-to-handdrawn-video

A Remotion-based tool that converts Chinese story text or ordered hand-drawn images into vertical hand-drawn diary-comic animation with handwritten captions, left-to-right reveals, optional page-curl transitions, and silent H.264 output for post-production dubbing.

AI & Machine LearningAI Agents

683

7-e1even

Featured

learn-agent

A collection of notes on building coding agents, derived from the production development of the desktop agent Reina, with each mechanism simplified into a zero-dependency, single-file Node.js demo.

AI & Machine LearningLarge Language Models

218