{"id":28632591,"url":"https://github.com/dceluis/page-llm","last_synced_at":"2025-07-06T00:08:11.917Z","repository":{"id":297818966,"uuid":"997998354","full_name":"dceluis/page-llm","owner":"dceluis","description":"A simple extension to talk with the current page","archived":false,"fork":false,"pushed_at":"2025-06-07T17:00:51.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-07T17:35:46.883Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/dceluis.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}},"created_at":"2025-06-07T16:44:24.000Z","updated_at":"2025-06-07T17:00:55.000Z","dependencies_parsed_at":"2025-06-07T17:47:02.221Z","dependency_job_id":null,"html_url":"https://github.com/dceluis/page-llm","commit_stats":null,"previous_names":["dceluis/page-llm"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dceluis/page-llm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dceluis%2Fpage-llm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dceluis%2Fpage-llm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dceluis%2Fpage-llm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dceluis%2Fpage-llm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dceluis","download_url":"https://codeload.github.com/dceluis/page-llm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dceluis%2Fpage-llm/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263828725,"owners_count":23516790,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2025-06-12T14:10:12.092Z","updated_at":"2025-07-06T00:08:06.902Z","avatar_url":"https://github.com/dceluis.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Page LLM\n\nA simple browser extension to chat with the current webpage using your own Google Gemini or OpenAI API key.\n\n\u003cimg src=\"public/page-llm.png\" alt=\"Page-LLM\" width=\"200\"/\u003e\n\nPage LLM allows you to leverage powerful large language models directly on any webpage. Use it to summarize long articles, explain complex topics, define terms, or ask any question about the page's content.\n\n## Features\n\n-   **Interact with Page Content**: Sends the text from the current page to an AI model along with your instructions.\n-   **Bring Your Own API Key**: Securely use your personal Google or OpenAI API keys. Your keys are stored locally in your browser and never sent to a third-party server.\n-   **Provider Choice**: Switch between Google Gemini and OpenAI models.\n-   **Model Selection**: Choose from a curated list of modern, efficient models.\n-   **Quick Prompts**: Get started quickly with pre-defined prompts for common tasks like summarizing or explaining concepts.\n-   **Simple Interface**: A clean and intuitive popup UI for a seamless experience.\n\n## Installation\n\nYou can install the extension in two ways: by using a pre-built package or by building it from the source code.\n\n### Method 1: From a Pre-built Package (Recommended)\n\nThis is the easiest way to get started.\n\n1.  Download the latest release package for your browser (e.g., `chrome-mv3.zip` or `firefox-mv3.zip`) from the project's **Releases** page or the `dist/` directory.\n2.  Unzip the downloaded file into a dedicated folder.\n3.  Follow the instructions for your browser:\n\n    **For Google Chrome or Microsoft Edge:**\n    -   Open your browser and navigate to `chrome://extensions`.\n    -   Enable **Developer mode** using the toggle in the top-right corner.\n    -   Click the **Load unpacked** button.\n    -   Select the folder where you unzipped the extension.\n\n    **For Mozilla Firefox:**\n    -   Open Firefox and navigate to `about:addons`.\n    -   Click the gear icon in the top-right and select **Debug Add-ons**.\n    -   Click the **Load Temporary Add-on...** button.\n    -   Select the `manifest.json` file inside the folder where you unzipped the extension.\n\nThe Page LLM icon should now appear in your browser's toolbar.\n\n### Method 2: Building from Source\n\nIf you want to build the extension yourself, you'll need [Node.js](https://nodejs.org/) and a package manager like `npm` or `bun`.\n\n1.  **Clone the repository:**\n    ```bash\n    git clone https://github.com/your-username/page-llm.git\n    cd page-llm\n    ```\n\n2.  **Install dependencies:**\n    ```bash\n    npm install\n    # or: bun install\n    ```\n\n3.  **Build the extension:**\n    ```bash\n    npm run build\n    # or for Firefox: npm run build:firefox\n    ```\n    This command will create a build directory inside `.output/` (e.g., `.output/chrome-mv3`).\n\n4.  **Load the extension** by following the \"Load unpacked\" or \"Load Temporary Add-on\" steps from Method 1, but point to the build directory (e.g., `.output/chrome-mv3`).\n\n## How to Use\n\n1.  **Configure Settings:**\n    -   After installation, click the Page LLM icon in your toolbar. You may be directed to the options page, or you can right-click the icon and select \"Options\".\n    -   Choose your preferred **AI Provider** (Google Gemini or OpenAI).\n    -   Enter your **API Key** for the selected provider. You can click \"SHOW\" to verify it.\n    -   Select a **Model** from the dropdown list.\n    -   Click **Save Settings**.\n\n2.  **Interact with a Page:**\n    -   Navigate to any webpage you want to interact with.\n    -   Click the Page LLM icon in the toolbar to open the popup.\n    -   Type your instruction in the text box (e.g., \"Summarize this article in three bullet points.\").\n    -   Alternatively, select a **Quick Prompt** from the dropdown to pre-fill the instruction box.\n    -   Click the send button or press `Cmd+Enter` (Mac) / `Ctrl+Enter` (Windows).\n    -   The AI's response will appear in the \"Output\" area. You can easily copy it to your clipboard using the copy button.\n\n## Development\n\nInterested in contributing? Here’s how to get a development environment running:\n\n1.  Follow steps 1 and 2 from the \"Building from Source\" section.\n2.  Run the development command:\n    ```bash\n    npm run dev\n    # or for Firefox: npm run dev:firefox\n    ```\n3.  This will start the WXT development server with hot-reloading. Load the extension into your browser using the `.output/` directory as described above. Any changes you make to the source code will be reflected automatically.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdceluis%2Fpage-llm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdceluis%2Fpage-llm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdceluis%2Fpage-llm/lists"}