Initial PHANTOM open-source release

Author: borhend

.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.13"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements.txt
+
+      - name: Compile
+        run: python -m py_compile phantom.py phantom_cli.py core/*.py memory/__init__.py tools/*.py integrations/*.py evals/*.py tests/*.py
+
+      - name: Unit tests
+        run: python -m unittest discover -s tests -v
+
+      - name: Offline evals
+        run: |
+          export PHANTOM_HOME="$PWD/.phantom-ci"
+          export PHANTOM_WORKSPACE="$PWD"
+          python phantom.py --evals

.gitignore

@@ -0,0 +1,23 @@
+.DS_Store
+__pycache__/
+*.py[cod]
+*.so
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+.venv/
+.phantom/
+
+.env
+.env.*
+
+*.log
+*.sqlite
+*.sqlite3
+
+playwright-report/
+test-results/
+
+.coverage
+htmlcov/

CODE_OF_CONDUCT.md

@@ -0,0 +1,45 @@
+# Code Of Conduct
+
+## Our Standard
+
+PHANTOM is built in public, and we want the project to feel welcoming to people who are curious, thoughtful, and serious about building useful systems.
+
+We expect contributors to:
+
+- be respectful and constructive
+- disagree with ideas without attacking people
+- assume good intent while still being clear and honest
+- help make the project understandable for newcomers
+- avoid harassment, intimidation, or exclusionary behavior
+
+## Scope
+
+This applies to:
+
+- issues
+- pull requests
+- discussions
+- documentation
+- project chat spaces tied to PHANTOM
+
+## Unacceptable Behavior
+
+Examples include:
+
+- personal attacks or insults
+- harassment or discrimination
+- doxxing or sharing private information without consent
+- deliberate disruption, spam, or bad-faith participation
+- hostile behavior that makes collaboration unsafe
+
+## Maintainer Responsibility
+
+Project maintainers may edit, remove, or reject content that violates this code of conduct. They may also temporarily or permanently restrict participation when needed to protect the project and its contributors.
+
+## Reporting
+
+If you see a problem, report it privately through the contact path in [`SECURITY.md`](SECURITY.md) or by opening a respectful maintainer contact request.
+
+## Enforcement Philosophy
+
+We want a project that is technically rigorous and welcoming. Enforcement should protect contributors, reduce unnecessary conflict, and keep the work moving.

CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# Contributing to PHANTOM
+
+Thanks for contributing.
+
+## Local Setup
+
+```bash
+python3 -m venv .venv
+. .venv/bin/activate
+python3 -m pip install -r requirements.txt
+python3 -m playwright install chromium
+```
+
+## Run Checks
+
+```bash
+python3 -m unittest discover -s tests -v
+.venv/bin/python phantom.py --evals
+```
+
+## Contribution Guidelines
+
+- keep changes small and reviewable
+- preserve local-first and human-control behavior
+- add or update tests for behavior changes
+- do not weaken safety checks to land a feature quickly
+- document new CLI flags and environment variables in `README.md`
+
+## Areas That Need Work
+
+- planner grounding and plan quality
+- provider reliability and benchmark harnesses
+- stronger generated-skill isolation
+- browser workflow robustness
+- better product demos and example workflows

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 borhen68
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 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.