ai-ify 0.1.0__tar.gz

ai_ify-0.1.0/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/MANIFEST.in

@@ -0,0 +1,3 @@
+include README_AI.md
+include aiify_context.json
+include LICENSE

ai_ify-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,65 @@
+# 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.