ai-ify 0.1.0__py3-none-any.whl

ai_ify-0.1.0.dist-info/METADATA

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: ai-ify
+Version: 0.1.0
+Summary: Embed a subscription-backed AI agent inside any app, controlled the way the developer allows
+Author: Brancaccio Lab
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Jay2owe/ai-ify
+Project-URL: Documentation, https://github.com/Jay2owe/ai-ify/blob/main/docs/embedding-guide.md
+Project-URL: Issues, https://github.com/Jay2owe/ai-ify/issues
+Project-URL: Changelog, https://github.com/Jay2owe/ai-ify/blob/main/CHANGELOG.md
+Keywords: ai agent,embedded assistant,agent client protocol,claude,codex
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: src/aiify/static/vendor/PAGE_CONTROLLER_LICENSE
+Requires-Dist: agent-client-protocol<0.13,>=0.12
+Provides-Extra: web
+Requires-Dist: fastapi>=0.115; extra == "web"
+Requires-Dist: uvicorn>=0.30; extra == "web"
+Requires-Dist: websockets>=12; extra == "web"
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == "test"
+Requires-Dist: httpx>=0.27; extra == "test"
+Requires-Dist: playwright<2,>=1.49; extra == "test"
+Provides-Extra: release
+Requires-Dist: build>=1.2; extra == "release"
+Requires-Dist: twine>=6.1; extra == "release"
+Dynamic: license-file
+
+# ai-ify
+
+Embed an AI agent inside any app. The person chats with it in a panel inside
+the app (or opens a console on the same conversation); the agent runs on the
+Claude or Codex subscription already logged in on the machine, and controls the
+app only in the ways the app's developer allows: backend actions, named UI
+commands, and an automatic tree of the page's controls.
+
+## Install
+
+```bash
+pip install "ai-ify[web]"     # chat panel for FastAPI apps
+pip install ai-ify            # control port and the aiify command only
+```
+
+Also needed: Node.js with `npx` (the first chat downloads the agent adapter), and
+a signed-in subscription (`claude` once, or `codex login`). No API key is used.
+
+## Use
+
+```python
+from aiify import Agent, Profile
+from aiify.actions import from_functions
+
+agent = Agent(
+    app="myapp",
+    actions=from_functions({"notes.add": add_note, "notes.clear": clear_notes},
+                           destructive=["notes.clear"]),
+    profiles={"default": Profile(provider="claude")},
+)
+agent.mount(fastapi_app)          # chat panel + websocket + local control port
+```
+
+and in the page:
+
+```html
+<script src="/aiify/panel.js" defer></script>
+```
+
+Destructive actions show a "Run it?" card before they run. Agents (the embedded
+one, or any other on the machine) reach the running app with the `aiify` command:
+`aiify apps`, `aiify --app myapp action.list`, `aiify --app myapp ui tree`.
+
+## Documentation
+
+- Usage guide, shipped with the package: `python -m aiify.context [topic]`, or
+  `from aiify import context; print(context.read())`. Also as
+  [README_AI.md](https://github.com/Jay2owe/ai-ify/blob/main/README_AI.md).
+- [Embedding guide](https://github.com/Jay2owe/ai-ify/blob/main/docs/embedding-guide.md),
+  with Circadian Workbench as the worked example.
+- [Message format](https://github.com/Jay2owe/ai-ify/blob/main/docs/protocol.md).
+
+## Development
+
+```bash
+python -m venv .venv
+.venv/bin/python -m pip install -e ".[web,test]"     # Windows: .venv\Scripts\python.exe
+.venv/bin/python -m pytest -m "not browser"          # browser tests need Edge or Playwright's Chromium
+```
+
+Releases are published by GitHub Actions when a `vX.Y.Z` tag matching the
+package version is pushed ([RELEASING.md](https://github.com/Jay2owe/ai-ify/blob/main/RELEASING.md)).
+
+Install name `ai-ify`, import name `aiify`. MIT licence. The bundled
+`page-controller` (Alibaba, MIT) builds the page control tree.

ai_ify-0.1.0.dist-info/RECORD

@@ -0,0 +1,44 @@
+ai_ify-0.1.0.dist-info/licenses/LICENSE,sha256=19o-ubrGLho02Ng4NU0UoD75T9MQVtPH_5d-wZNshhE,1071
+ai_ify-0.1.0.dist-info/licenses/src/aiify/static/vendor/PAGE_CONTROLLER_LICENSE,sha256=DK75UqN8Itgd6I0z44Iup_YRnb_TvNzXDMg2CKeF2J4,2491
+aiify/README_AI.md,sha256=WElpAVIaWArCPVFTP1HgRcvApOUYxNFmN-hsNoMTfzE,23068
+aiify/__init__.py,sha256=IHPaHeDkE4Srn98sdzlR0qENmh1gvJ81cTUEWOyq5Kc,688
+aiify/__main__.py,sha256=ttCWlmtOvOezzkpLP1nFXVyGAaYhogWhnCSNvEnNxUc,120
+aiify/accounts.py,sha256=CVmpoYTn98JsIWw-F6A5T1AB0LXUB4tqURz5eZLA8TE,5621
+aiify/actions.py,sha256=4rJW5BqHlkIVMg21R7Eclb-yABN08deMxhieMCX3NcE,18161
+aiify/agent.py,sha256=FbSrQCEbzOcqiGdbRvMDAiP0PkyOHLvfPxyl-_l7xF0,28234
+aiify/aiify_context.json,sha256=1J9xNUseSJusxGXJ7GMFQSae2Rn_vIrz6yNRO4Ioy-k,28113
+aiify/cli.py,sha256=W1TNl3MmVqrmw2H04SY4vLQIwk7zaZIN-U4cfbjvRW4,5623
+aiify/console.py,sha256=_Y45LDByFOoz_t6r6WkrFiUhCk0tk1JTcLjRc83lNak,5244
+aiify/context.py,sha256=ITD8I1YNxHcGedBK6EinSce3J3abQ_Z18SwxqhbWh6M,9658
+aiify/control_port.py,sha256=NHOpcCodLppAaBIZRfSZW2Q4N9C7zMNc8pwTXHfXFXw,8986
+aiify/engine.py,sha256=HBwmG5XTMvK73xbApH4wAT9YbnldyrL-3wt1WJuXi6w,19039
+aiify/policy.py,sha256=8aTHWF8UuSj-HO2DO0-xlk_gRv--Bt5NRk2Hv3jMSoQ,1327
+aiify/profile.py,sha256=SDF7xaYzoa5irIHIFqhx8ncQTwlwhcC-uMO99Gj0JAE,2089
+aiify/prompting.py,sha256=UGiN_z9_rac-MEcrc0RJxD8E3TBkZwW1kIVTYCxX6Ro,4564
+aiify/protocol.py,sha256=5RusisErQ-VYgIp8Vfh0_pJXr55ztRJwFzKbmwVgl5g,3305
+aiify/ui_relay.py,sha256=uSloXSW_ctSCWoOYDfv0B_sgucCr7YC5UaXHUSTAl7s,7080
+aiify/usage.py,sha256=MqPASJ38o8_IQ4wW6hl1ShQ3noA996SljZHmb3YBLC8,14014
+aiify/web.py,sha256=914H5nAStmc5xPsAnXTahiXibzKwuLcI2NUHY-UFHhs,6802
+aiify/guide/actions.md,sha256=u-eMtM_9NmcidxAxZ7dcN-mvyRlYv8uPRgIAZLkiSiI,1954
+aiify/guide/agent-commands.md,sha256=XHHr-RAd20tuh7mQfoqseoftm3RXDQ-HfkMJrwKiOEw,1735
+aiify/guide/console-and-limits.md,sha256=cvrZDfyb46jHY4XJWHlv7PjiQJBvR0215RCf6JqCPQM,1461
+aiify/guide/other-apps.md,sha256=3TP36tLUnqf33kq3-UaurxE7B2kBWXGexVpvkH-1kMg,1171
+aiify/guide/overview.md,sha256=Ta16pKO3gIlmSq-aRIKtKNn8DVm1MHa_WMeU7_XCyfE,1362
+aiify/guide/page-control.md,sha256=U9g1M_TmFPh8aRl68Xx9-iAH5bN8xupME_eRpB7LAkE,1859
+aiify/guide/profiles.md,sha256=rLBIu8hly_5_tznDLmB6oKH6dmiW0eM6TAc6c0-oKcA,1861
+aiify/guide/quickstart.md,sha256=-Klje5sYsakXxdEUUl6p6EEh8Gwm0AURZMWlTX3g23Q,1965
+aiify/guide/setup.md,sha256=EEUEQ7lYqAYIaZQaNZb1eH5_g22yi5Tf3Nt10QFao4I,1518
+aiify/guide/testing.md,sha256=Zb7x8OlT6lPi4LR_Md6fsG9ySCIM1mFdtEoosZ4TcsY,1417
+aiify/guide/troubleshooting.md,sha256=_lLJieJfG5Ymt4gwlocubf_EdjQYxjkoeH2-C95vxs4,1886
+aiify/static/bridge.js,sha256=idNr1_NRh1yflrhSaskvQn-xjNf8442_vT3WOg-9ujI,14079
+aiify/static/panel.css,sha256=o1ECA8CtH9uEt26IJQeNmvteNZ2Q5ZWFF0XQkvk__4A,6656
+aiify/static/panel.js,sha256=HnfvoZxhRANoRfHmscXdEjswUrF4r2rhiocdXcCb1Aw,17973
+aiify/static/vendor/PAGE_CONTROLLER_LICENSE,sha256=DK75UqN8Itgd6I0z44Iup_YRnb_TvNzXDMg2CKeF2J4,2491
+aiify/static/vendor/page-controller.js,sha256=42rFQeKqZRQ8GZb2b_fJnhaxXsd95OMrubKzU94Unc8,104479
+aiify/testing/__init__.py,sha256=QvfKlic2wjX2hT60oti4F3YNKgm2Dvp47XZ56yi-418,235
+aiify/testing/fake_agent.py,sha256=U52yEHOmGQSYgTQVSMP5QrU4omEDyPm_EWJWFjwjAlk,6555
+ai_ify-0.1.0.dist-info/METADATA,sha256=YvlMHJUfnW2ikBHRHbwm3LGW1pFZcgJKOoTLvfIrzCc,4305
+ai_ify-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+ai_ify-0.1.0.dist-info/entry_points.txt,sha256=AOFoMx98t8dwaJplyo2BA1idusGmCWlghQVSMuXC6Mc,41
+ai_ify-0.1.0.dist-info/top_level.txt,sha256=vTf-mYmZwfzANOjENBvSIo1Xc8R8QfPLZJbL_NV5cHc,6
+ai_ify-0.1.0.dist-info/RECORD,,

ai_ify-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ai_ify-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+aiify = aiify.cli:main

ai_ify-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brancaccio Lab
+
+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.

ai_ify-0.1.0.dist-info/licenses/src/aiify/static/vendor/PAGE_CONTROLLER_LICENSE

@@ -0,0 +1,51 @@
+Vendored file: page-controller.js
+Package: @page-agent/page-controller 1.12.4 (https://github.com/alibaba/page-agent, packages/page-controller)
+Bundled dependency: ai-motion 0.4.8
+Bundled 2026-10-01 with esbuild (ESM, unminified).
+
+=== @page-agent/page-controller ===
+MIT License
+
+Copyright (c) 2026 SimonLuvRamen
+Copyright (c) 2026 Alibaba Group Holding Limited
+
+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.
+
+=== ai-motion ===
+MIT License
+
+Copyright (c) 2025 Simon<gaomeng1900@gmail.com>
+
+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.

ai_ify-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+aiify