@doppelgangerdev/doppelganger 0.2.2

package/.dockerignore

@@ -0,0 +1,9 @@
+node_modules
+dist
+data
+storage_state.json
+.git
+.env
+public/screenshots
+.vscode
+.DS_Store

package/.github/workflows/docker-publish.yml

@@ -0,0 +1,59 @@
+name: Publish Docker Image
+
+on:
+  push:
+    branches: ['main', 'beta']
+    tags: ['v*']
+
+env:
+  GH_REGISTRY: ghcr.io
+  D_HUB_REPO: mnemosyneai/doppelganger
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    env:
+      D_HUB_TOKEN: ${{ secrets.DOCKERHUB_TOKEN }}
+      D_HUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME || vars.DOCKERHUB_USERNAME }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.GH_REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Log in to Docker Hub
+        if: env.D_HUB_TOKEN != ''
+        uses: docker/login-action@v3
+        with:
+          username: ${{ env.D_HUB_USERNAME }}
+          password: ${{ env.D_HUB_TOKEN }}
+
+      # Build tags dynamically
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            ghcr.io/${{ github.repository }}
+            ${{ env.D_HUB_TOKEN != '' && env.D_HUB_REPO || '' }}
+          tags: |
+            type=raw,value=latest,enable=${{ github.ref == 'refs/heads/main' }}
+            type=raw,value=beta,enable=${{ github.ref == 'refs/heads/beta' }}
+            type=semver,pattern={{version}}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,28 @@
+# Code of Conduct
+
+This project is committed to providing a welcoming, safe, and professional environment for everyone.
+
+## Our Standards
+We expect participants to:
+- Be respectful and considerate in language and actions.
+- Assume good intent and collaborate constructively.
+- Focus on technical merit and helpful feedback.
+- Respect privacy and avoid sharing personal data.
+
+Unacceptable behavior includes:
+- Harassment, discrimination, or abusive language.
+- Trolling, spamming, or deliberate disruption.
+- Doxing or sharing private information.
+
+## Scope
+This Code of Conduct applies to all project spaces, including issues, pull requests, discussions, and community channels.
+
+## Reporting
+If you experience or witness unacceptable behavior, report it to the project maintainers.
+Include as much detail as possible so we can address the issue responsibly.
+
+## Enforcement
+The maintainers may take any action they deem appropriate, including warnings, temporary bans, or permanent removal from project spaces.
+
+## Acknowledgment
+This Code of Conduct is adapted from common open source community standards.

package/CONTRIBUTING.md

@@ -0,0 +1,42 @@
+# Contributing
+
+Thanks for your interest in contributing to Mnemosyne Doppelganger. This guide explains how to propose changes safely and efficiently.
+
+## Ways to Contribute
+- Report bugs with clear reproduction steps
+- Suggest improvements or UX refinements
+- Submit fixes or new features
+- Improve documentation and examples
+
+## Before You Start
+- Check existing issues and discussions to avoid duplicates.
+- Keep changes focused and small when possible.
+- For larger changes, open an issue first to align on approach.
+
+## Development Setup
+```bash
+npm install
+npm run build
+npm run start
+```
+
+If using dev mode, ensure the frontend and backend ports match your proxy configuration.
+
+## Coding Guidelines
+- Prefer clear, readable code over cleverness.
+- Keep UI changes consistent with the existing style.
+- Avoid adding heavy dependencies unless necessary.
+- Use ASCII characters in source files unless there is a clear reason.
+
+## Pull Requests
+Include:
+- A short summary of what changed and why
+- Screenshots or GIFs for UI changes
+- Notes about testing performed
+
+## Security and Responsible Use
+- Do not include credentials or private data in issues or PRs.
+- Respect the project license restrictions for commercial use.
+
+## License
+By contributing, you agree that your contributions are licensed under the project license in `LICENSE`.

package/Dockerfile

@@ -0,0 +1,44 @@
+FROM node:22-bullseye AS build
+
+WORKDIR /app
+
+# Install deps (include dev deps for build)
+COPY package*.json ./
+RUN npm ci --include=dev
+
+# Build frontend
+COPY . .
+RUN npm run build
+
+FROM mcr.microsoft.com/playwright:v1.40.0-focal AS runtime
+
+WORKDIR /app
+
+# Install VNC + Xvfb for headful sessions in Docker
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        xvfb \
+        x11vnc \
+        novnc \
+        websockify \
+        curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install production deps only
+COPY package*.json ./
+RUN npm ci --omit=dev
+
+# Ensure Playwright browsers + OS deps are available
+RUN npx playwright install --with-deps chromium chrome firefox
+
+# Copy server and built assets
+COPY --from=build /app/dist /app/dist
+COPY --from=build /app/public /app/public
+COPY --from=build /app/*.js /app/
+COPY --from=build /app/start-vnc.sh /app/start-vnc.sh
+
+EXPOSE 11345
+EXPOSE 54311
+ENV NODE_ENV=production
+
+CMD ["bash", "/app/start-vnc.sh"]

package/LICENSE

@@ -0,0 +1,163 @@
+                      SUSTAINABLE USE LICENSE (SUL) v1.0
+
+Copyright (c) 2025
+
+This License governs use of the software and associated documentation (the "Software").
+By using, copying, modifying, or distributing the Software, you agree to all terms below.
+
+1. Definitions
+   1.1 "Software" means the source code, object code, binaries, and documentation.
+   1.2 "You" means any individual or entity exercising rights under this License.
+   1.3 "Non-Commercial" means not primarily intended for or directed toward commercial
+       advantage or monetary compensation.
+   1.4 "Hosted Service" means making the Software or any portion of its functionality
+       available to third parties over a network, including SaaS, managed services,
+       platform services, or public API offerings.
+   1.5 "Derivative Work" means any modification, adaptation, or other work based on
+       the Software.
+   1.6 "Distribution" means providing the Software to any third party by any means,
+       including source code, binaries, containers, or images.
+   1.7 "Competing Product" means a product or service that provides materially
+       similar functionality to the Software.
+   1.8 "Author(s)" means the copyright holder(s) of the Software.
+
+2. Grant of Rights
+   2.1 You may read, inspect, and modify the Software for personal, internal, or
+       Non-Commercial use.
+   2.2 You may run the Software on your own machines or infrastructure.
+   2.3 You may create and share community tutorials, examples, and presets.
+   2.4 You may modify the Software for personal automation, data extraction, or
+       experimentation.
+   2.5 You may share patches or snippets for Non-Commercial purposes, provided you
+       include required attribution.
+
+3. Restrictions on Use
+   3.1 You may not offer the Software as a Hosted Service.
+   3.2 You may not redistribute the Software for commercial hosting or for
+       Competing Products.
+   3.3 You may not sell, sublicense, rent, lease, or commercially exploit the
+       Software as a standalone product or as part of any paid service.
+   3.4 You may not use the Software in a manner that violates applicable law or
+       third-party terms, including terms of websites or services you interact with.
+   3.5 You may not remove, alter, or obscure any copyright, license, or attribution
+       notices.
+   3.6 You may not imply endorsement, sponsorship, or affiliation by the Author(s)
+       without prior written permission.
+   3.7 You may not circumvent technological restrictions or access controls in
+       violation of applicable law.
+
+4. Redistribution and Attribution
+   4.1 Any Distribution of source code or Derivative Works must retain this License
+       and all notices.
+   4.2 If you redistribute source code that includes any part of the Software and
+       the redistribution is not a Hosted Service, you must credit the Author(s)
+       prominently in the source and in accompanying documentation.
+   4.3 You may not impose additional restrictions that conflict with this License.
+   4.4 Distribution of binaries or compiled artifacts is prohibited unless expressly
+       permitted in writing by the Author(s).
+   4.5 Public repositories containing the Software must retain this License file.
+
+5. Ownership and IP
+   5.1 The Software is licensed, not sold.
+   5.2 Title, ownership, and intellectual property rights in the Software remain
+       with the Author(s).
+   5.3 This License does not grant rights in any trademarks, logos, or branding.
+
+6. Compliance and Lawful Use
+   6.1 You are solely responsible for your use of the Software and compliance with
+       all applicable laws, regulations, and third-party terms.
+   6.2 The Software does not grant any right to access systems, data, or content
+       without permission.
+   6.3 You must not use the Software for unlawful, harmful, or unauthorized
+       activities.
+   6.4 You are solely responsible for obtaining any required permissions, consents,
+       or licenses.
+   6.5 You bear all responsibility for the accuracy, integrity, and legality of
+       any data processed or collected using the Software.
+
+7. Security and Misuse
+   7.1 The Software may be used for automation, testing, or data extraction; such
+       use is at your own risk.
+   7.2 You are responsible for securing your systems, credentials, and any data
+       generated or stored by the Software.
+   7.3 The Author(s) do not monitor, control, or endorse your usage.
+   7.4 You agree to indemnify and hold harmless the Author(s) against any claims,
+       damages, losses, or liabilities arising from your use of the Software.
+
+8. No Warranty
+   8.1 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+       IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS
+       FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+   8.2 The Author(s) make no representations about accuracy, reliability, or
+       availability of the Software.
+   8.3 You assume all risk for use of the Software.
+
+9. Limitation of Liability
+   9.1 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+       DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR
+       OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE
+       USE OR OTHER DEALINGS IN THE SOFTWARE.
+   9.2 The foregoing limitation applies even if the Author(s) have been advised of
+       the possibility of such damages.
+   9.3 In jurisdictions that do not allow limitation of liability, liability is
+       limited to the maximum extent permitted by law.
+
+10. Third-Party Components
+   10.1 The Software may include or depend on third-party libraries or services.
+   10.2 Those components are subject to their own licenses and terms.
+   10.3 You are responsible for compliance with any third-party requirements.
+
+11. Privacy and Data
+   11.1 You are responsible for handling personal data lawfully and securely.
+   11.2 The Author(s) do not collect, transmit, or store your data unless you
+       explicitly configure the Software to do so.
+   11.3 You are responsible for any disclosures or notices required by law.
+
+12. Export and Sanctions
+   12.1 You must comply with all applicable export control and sanctions laws.
+   12.2 You may not use or export the Software in violation of such laws.
+
+13. Commercial Licensing
+   13.1 This License does not grant any commercial rights beyond those expressly
+       permitted.
+   13.2 The Author(s) reserve the right to offer separate commercial licenses,
+       Hosted Services, or enterprise features at their discretion.
+   13.3 If you seek commercial rights, you must obtain a separate written license.
+
+14. Feedback
+   14.1 You may provide feedback, suggestions, or improvements.
+   14.2 You grant the Author(s) a perpetual, irrevocable, worldwide, royalty-free
+       license to use, modify, and incorporate feedback into the Software.
+
+15. Termination
+   15.1 Any breach of this License automatically terminates your rights to use the
+       Software.
+   15.2 Upon termination, you must cease all use and delete all copies in your
+       possession or control.
+   15.3 Sections that by their nature should survive termination shall survive,
+       including Sections 5 through 15.
+
+16. Notice of Violations
+   16.1 The Author(s) may enforce this License at their discretion.
+   16.2 Failure to enforce any provision is not a waiver of future enforcement.
+
+17. Severability
+   17.1 If any provision is held to be unenforceable, the remaining provisions
+       remain in full force and effect.
+
+18. Entire Agreement
+   18.1 This License constitutes the entire agreement regarding the Software and
+       supersedes prior agreements on this subject.
+
+19. Changes to License
+   19.1 The Author(s) may publish updated versions of this License.
+   19.2 Continued use of the Software after an updated License is published
+       constitutes acceptance of the updated terms.
+
+20. Contact
+   20.1 For commercial licensing inquiries or permissions, contact the Author(s)
+       through the official project channels.
+
+21. Third-Party Components
+   21.1 All third party components incorporated into the Software are licensed
+       under the original license provided by the owner of the applicable component.

package/README.md

@@ -0,0 +1,133 @@
+# Doppelganger
+
+[![Docker](https://img.shields.io/badge/docker-mnemosyneai%2Fdoppelganger-0db7ed)](https://hub.docker.com/r/mnemosyneai/doppelganger)
+[![Self-Hosted](https://img.shields.io/badge/self--hosted-local--first-2f855a)](#getting-started)
+
+Doppelganger is a self-hosted, developer-focused browser automation and extraction tool. It runs locally via Docker and provides a DIY workflow for building automation tasks with blocks and optional JavaScript customization.
+
+This project is designed for local, controlled use cases. It does not claim to bypass protections and does not encourage unlawful activity.
+
+## Getting Started (Docker)
+
+### Requirements
+- Docker Desktop or Docker Engine
+- x86_64 or ARM64 host
+- 4GB+ RAM recommended
+
+### Pull the Image
+```bash
+docker pull mnemosyneai/doppelganger
+```
+
+### Run the Container
+```bash
+docker run -d \
+  --name doppelganger \
+  -p 11345:11345 \
+  -e SESSION_SECRET=change_me_to_a_long_random_value \
+  -v $(pwd)/data:/app/data \
+  -v $(pwd)/public:/app/public \
+  -v $(pwd)/storage_state.json:/app/storage_state.json \
+  mnemosyneai/doppelganger
+```
+
+Open the dashboard at:
+```
+http://localhost:11345
+```
+
+### Session Secret
+Set a strong, unique secret via `SESSION_SECRET` before starting the container.
+
+Example:
+```bash
+export SESSION_SECRET="$(node -e 'console.log(require("crypto").randomBytes(32).toString("hex"))')"
+```
+
+### Update to Latest
+```bash
+docker pull mnemosyneai/doppelganger
+docker stop doppelganger
+docker rm doppelganger
+docker run -d \
+  --name doppelganger \
+  -p 11345:11345 \
+  -e SESSION_SECRET=change_me_to_a_long_random_value \
+  -v $(pwd)/data:/app/data \
+  -v $(pwd)/public:/app/public \
+  -v $(pwd)/storage_state.json:/app/storage_state.json \
+  mnemosyneai/doppelganger
+```
+
+## Usage
+
+### Open the Dashboard
+Navigate to:
+```
+http://localhost:11345
+```
+
+### Create a Task (Block-Based)
+1. Click **New Task**
+2. Choose a mode (Scrape, Agent, Headful)
+3. Add action blocks (click, type, hover, wait, scroll, press, javascript)
+4. Configure variables and selectors
+5. Save and run
+
+### Example Workflow (Safe Demo)
+Goal: Load a public page, wait, and extract a title.
+1. Create a new task
+2. Set URL to `https://example.com`
+3. Add a **wait** block (2 seconds)
+4. Add a **javascript** block:
+```js
+return document.title;
+```
+5. Run the task and view the output
+
+### JSON Export
+In the task editor, open the JSON view and copy the task definition for reuse.
+
+### JavaScript Blocks
+JavaScript blocks allow custom extraction or page logic. Use them for:
+- Parsing DOM elements
+- Returning structured data
+- Adding custom logic to actions
+
+### Secure API Access
+Tasks can be executed via HTTP requests using the API key. This enables secure, automated access from other services.
+
+Key details:
+- Endpoint: `POST /tasks/:id/api`
+- Auth headers: `x-api-key: <key>` or `Authorization: Bearer <key>`
+- Variables: send `variables` (or `taskVariables`) in the JSON body to override task variables
+- API key: generate or set one in **Settings** → **API Key** (stored locally)
+
+Example:
+```bash
+curl -X POST http://localhost:11345/tasks/task_123/api \
+  -H "Content-Type: application/json" \
+  -H "x-api-key: YOUR_API_KEY" \
+  -d "{\"variables\":{\"query\":\"example.com\"}}"
+```
+
+## Community and Presets
+Community-contributed presets or examples may be shared in the future.
+- Use community content at your own risk
+- The author is not responsible for community content
+- Always use the tool safely and legally
+
+## License
+This project uses a Sustainable Use License (SUL). See `LICENSE`.
+
+## Disclaimer
+The software is provided "as-is" without warranty. You are solely responsible for:
+- Your scripts and automation behavior
+- The data you access or collect
+- Any consequences of use
+
+Do not use this tool in ways that violate laws or third-party terms.
+
+## Links
+- Homepage/Docs: https://doppelgangerdev.com
+- Docker Hub: https://hub.docker.com/r/mnemosyneai/doppelganger

package/TERMS.md

@@ -0,0 +1,16 @@
+# Terms of Service
+
+By using Doppelganger, you agree to the terms below.
+
+1. Responsibility
+   - You are solely responsible for your scripts, automation, and any consequences of use.
+   - You are responsible for complying with all applicable laws and third-party terms.
+
+2. Prohibited Use
+   - You may not offer the software as a hosted service or SaaS product.
+   - You may not redistribute the software for commercial hosting or competing products.
+   - You may not sell or license the software as a standalone product or as part of any paid service.
+
+3. No Warranty
+   - The software is provided "as-is" without warranty of any kind, express or implied.
+   - The authors are not liable for damages, misuse, or data loss.