{"id":25998515,"url":"https://github.com/codecat1111/local-ai-assistant","last_synced_at":"2026-04-13T20:32:44.781Z","repository":{"id":278883830,"uuid":"937071958","full_name":"codecat1111/local-ai-assistant","owner":"codecat1111","description":"A local AI assistant that seamlessly integrates on-device AI models like DeepSeek with web browsers such as Chrome via extensions. It enables privacy-focused, real-time AI interactions without relying on cloud-based services.","archived":false,"fork":false,"pushed_at":"2025-05-31T05:35:14.000Z","size":401,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-06T23:07:38.240Z","etag":null,"topics":["deepseek-r1","extension-chrome","ollama"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codecat1111.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-22T09:08:01.000Z","updated_at":"2025-10-04T15:47:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"57f5a0f9-dfc4-4ed1-97bb-801c945cb560","html_url":"https://github.com/codecat1111/local-ai-assistant","commit_stats":null,"previous_names":["codecat1111/local-ai-assistant"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codecat1111/local-ai-assistant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecat1111%2Flocal-ai-assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecat1111%2Flocal-ai-assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecat1111%2Flocal-ai-assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecat1111%2Flocal-ai-assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codecat1111","download_url":"https://codeload.github.com/codecat1111/local-ai-assistant/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codecat1111%2Flocal-ai-assistant/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31770720,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T20:17:16.280Z","status":"ssl_error","status_checked_at":"2026-04-13T20:17:08.216Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deepseek-r1","extension-chrome","ollama"],"created_at":"2025-03-05T17:25:01.785Z","updated_at":"2026-04-13T20:32:44.746Z","avatar_url":"https://github.com/codecat1111.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Local AI Assistant - Chrome Extension ✨🖥️🚀\n\n## Why This is Powerful 💡🔒🚀\n\nThis AI-powered Chrome extension leverages a locally hosted model, eliminating API costs, reliance on external servers, and privacy concerns. Unlike cloud-based solutions, this approach ensures complete data security while offering seamless functionality.\n\nAdditionally, models such as DeepSeek, Mistral, and LLaMA can also be run locally, offering flexibility in choosing the best AI model for specific tasks. These models vary in size and capability, allowing users to optimize performance based on their hardware while still benefiting from a fully offline, privacy-focused AI assistant. You control the AI, ensuring reliability and performance without third-party interference. 🔐⚡🆓\n\n## Setting Up Ollama 🛠️🔧\n\nBefore running the extension, follow these steps to configure Ollama properly:\n\n1. **Install Ollama** from the official [Ollama website](https://ollama.ai/).\n2. **Download the model** you want to use (default: 300M parameters for optimal performance on most laptops). You can find official instructions for downloading and installing models in the [Ollama documentation](https://github.com/ollama/ollama/blob/main/README.md#model-library).\n3. **Configure Ollama to Accept Chrome Requests:**\n   - Open Windows PowerShell and execute:\n     ```powershell\n     ollama stop # Stops Ollama if running\n     $env:OLLAMA_ORIGINS=\"chrome-extension://*\"\n     $env:OLLAMA_HOST=\"0.0.0.0\"\n     ```\n4. **Start Ollama again** by running the following command in Windows PowerShell (For future use, you only need to run this command to start Ollama):\n   ```powershell\n   ollama serve\n   ```\n   This will launch the Ollama server and allow the Chrome extension to communicate with it. Ensure the server remains running to avoid `403 Forbidden` errors.\n5. **Keep the server running** in PowerShell to prevent a `403 Forbidden` error.\n\n## Installation 🛠️📥🔧\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/codecat1111/local-ai-assistant.git\n   cd ai-text-assistant\n   ```\n2. Ensure that Ollama is installed and operational.\n3. Navigate to `chrome://extensions/` in Google Chrome.\n4. Enable **Developer Mode** from the upper-right corner.\n5. Click **Load unpacked** and specify the `ai-text-assistant` directory. ⚙️🌐✅\n6. **Reload the extension and refresh the webpage** where you plan to use it.\n\n## Usage 🖱️📑🚀\n\n1. Select a segment of text within any active webpage.\n2. Launch the extension from the Chrome toolbar.\n3. Choose from one of the available analytical modes: Grammar Check, Code Review, Text Summarization, Social Media Post Generation, or General Text-Based Queries.\n4. Examine the processed output within an inline popup or an independent browser window. 🔍📊📝\n\n## System Architecture 🏗️🔍🛠️\n\nThis extension comprises multiple modular components:\n\n- **background.js**: Orchestrates communication with the Ollama model and manages asynchronous task execution.\n- **content.js**: Captures and transmits user-selected textual data from web pages.\n- **popup.js**: Implements the interactive graphical user interface.\n- **response.js**: Formats and displays the computational output returned by the AI model.\n- **manifest.json**: Configures essential permissions, runtime behaviors, and metadata for Chrome extension deployment.\n   \u003cp align=\"center\"\u003e\n     \u003cimg src=\"https://github.com/codecat1111/local-ai-assistant/blob/main/assets/architecture_dig.png\" width=\"50%\" alt=\"A Use-Case Diagram showing how the system works\"\u003e\n   \u003c/p\u003e\n   \u003cp align=\"center\"\u003e\u003cem\u003eA Use-Case Diagram showing how the system works\u003c/em\u003e\u003c/p\u003e\n\n## API Reference 📡📜📌\n\n### `queryOllama(prompt, model)`\n\nFacilitates communication with the locally hosted Ollama API for text analysis and transformation. 🤖🔍📊\n\n```javascript\nasync function queryOllama(prompt, model = \"qwen2.5:0.5b\")\n```\n\n- **Parameters:**\n  - `prompt` (string): The textual input to be processed by the model.\n  - `model` (string, optional): The computational model variant to be utilized (default: `qwen2.5:0.5b`).\n- **Returns:** A structured response containing AI-generated textual output. 📬📝🔬\n\n## Screenshots \u0026 Demo 🎥🖼️\n\n[**YouTube Demo Link(coming soon!)**](#)\n\nScreenshots: 📸🖥️📝\n1. Extension UI\n\n \u003cp align=\"center\"\u003e\n     \u003cimg src=\"https://github.com/codecat1111/local-ai-assistant/blob/main/assets/Screenshot 2025-02-22 153934.png\" width=\"90%\" alt=\"\u003eExtension UI\"\u003e\n   \u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eExtension UI\u003c/em\u003e\u003c/p\u003e\n\n2. Commands to run to start allow communication between Ollama and Chrome (or any browser)\n \u003cp align=\"center\"\u003e\n     \u003cimg src=\"https://github.com/codecat1111/local-ai-assistant/blob/main/assets/Screenshot 2025-02-22 154241.png\" width=\"50%\" alt=\"Commands to run to start allow communication between Ollama and Chrome (or any browser)\"\u003e\n   \u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eCommands to run to start allow communication between Ollama and Chrome (or any browser)\u003c/em\u003e\u003c/p\u003e\n3. A Summarize Feature in use\n\n \u003cp align=\"center\"\u003e\n     \u003cimg src=\"https://github.com/codecat1111/local-ai-assistant/blob/main/assets/Screenshot 2025-02-22 154639.png\" width=\"90%\" alt=\"An Ask Anything Feature in use\"\u003e\n   \u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eA Summarize Feature in use\u003c/em\u003e\u003c/p\u003e\n\n4. Server Side Logs\n\n \u003cp align=\"center\"\u003e\n     \u003cimg src=\"https://github.com/codecat1111/local-ai-assistant/blob/main/assets/Screenshot 2025-02-22 154735.png\" width=\"50%\" alt=\"Server Side Logs\"\u003e\n   \u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eServer Side Logs\u003c/em\u003e\u003c/p\u003e\n\n## Contribution Guidelines ✍️🔄🤝\n\n1. Fork the repository to your personal GitHub account.\n2. Create a dedicated feature branch for modifications:\n   ```bash\n   git checkout -b feature-name\n   ```\n3. Commit the changes and push to your forked repository:\n   ```bash\n   git commit -m \"Implemented feature enhancements\"\n   git push origin feature-name\n   ```\n4. Submit a pull request for review and integration. 🏗️📢✅\n\n## Licensing 📜⚖️🔓\n\nThis software is distributed under the MIT License. 🏆📄🛡️\n\n## ⭐ Found It Helpful? [Star It!](https://github.com/codecat1111/local-ai-assistant/stargazers)\n\nIf you found this project helpful, let the community know by giving it a [star](https://github.com/codecat1111/local-ai-assistant/stargazers): [👉⭐](https://github.com/codecat1111/local-ai-assistant/stargazers)\n\n---\n\nFor inquiries, feature requests, or to report issues, please utilize the GitHub issue tracking system or contribute via pull requests. 💬📢📩\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodecat1111%2Flocal-ai-assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodecat1111%2Flocal-ai-assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodecat1111%2Flocal-ai-assistant/lists"}