bailey 0.0.1__py3-none-any.whl

bailey/__init__.py

@@ -0,0 +1,13 @@
+"""Bailey: an open-source AI assistant that runs ready-made solutions.
+
+A solution is a complete, versioned package for one job: instructions, skills,
+tools, knowledge and small apps. Bailey installs one in a step, runs it on the
+user's own machine with the user's own AI key, and asks before a tool changes
+anything.
+
+This first release carries one command, ``bailey doctor``, which checks that a
+machine has what the assistant will need. It reads the local machine only and
+makes no network call.
+"""
+
+__version__ = "0.0.1"

bailey/__main__.py

@@ -0,0 +1,5 @@
+"""``python -m bailey``, the same as the ``bailey`` command."""
+
+from bailey.cli import main
+
+raise SystemExit(main())

bailey/cli.py

@@ -0,0 +1,41 @@
+"""``bailey``: the command line."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from collections.abc import Sequence
+
+from bailey import __version__
+from bailey.doctor import ready, render, run_checks
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="bailey",
+        description="An open-source AI assistant that runs ready-made solutions on your own machine.",
+    )
+    parser.add_argument("--version", action="version", version=f"bailey {__version__}")
+    commands = parser.add_subparsers(dest="command", required=True)
+    doctor = commands.add_parser(
+        "doctor",
+        help="check that this machine has what Bailey needs",
+        description=(
+            "Check that this machine has what Bailey needs: a recent Python, SQLite with full-text search, "
+            "and a loopback address for the app's local server; and, for some solutions, uv and Node.js. "
+            "Reads this machine only. Exits 1 when a required check fails."
+        ),
+    )
+    doctor.add_argument("--json", action="store_true", help="print the checks as JSON")
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    args = build_parser().parse_args(argv)
+    checks = run_checks()
+    if args.json:
+        sys.stdout.write(json.dumps([check.as_dict() for check in checks], indent=2) + "\n")
+    else:
+        sys.stdout.write(render(checks, version=__version__))
+    return 0 if ready(checks) else 1

bailey/doctor.py

@@ -0,0 +1,203 @@
+"""``bailey doctor``: does this machine have what Bailey needs?
+
+Each check says what it found, what Bailey uses it for, and what to do when it
+is missing. A *required* check is one the assistant cannot start without. The
+others are needed by some solutions only: a tool published as an npm package
+needs Node.js, and nothing else does. So they are reported, and they never
+fail the command.
+
+It reads this machine and nothing else: no network call, no file written, and
+no environment variable printed. Every check takes what it probes as an
+argument, so the tests can hand it a machine that lacks something.
+"""
+
+from __future__ import annotations
+
+import shutil
+import socket
+import sys
+from collections.abc import Callable, Sequence
+from dataclasses import asdict, dataclass
+from typing import Any
+
+try:
+    import sqlite3
+except ImportError:  # a Python compiled without SQLite's headers, which some source builds are
+    sqlite3 = None  # type: ignore[assignment]
+
+MINIMUM_PYTHON = (3, 11)
+
+GET_PYTHON = "Install Python from python.org or with `uv python install`, then run `bailey doctor` again to confirm."
+
+
+@dataclass(frozen=True)
+class Check:
+    name: str
+    ok: bool
+    found: str
+    needed_for: str
+    required: bool
+    fix: str = ""
+
+    def as_dict(self) -> dict[str, Any]:
+        return asdict(self)
+
+
+def check_python(version_info: Sequence[int] = sys.version_info) -> Check:
+    ok = tuple(version_info[:2]) >= MINIMUM_PYTHON
+    return Check(
+        name="Python",
+        ok=ok,
+        found=".".join(str(part) for part in version_info[:3]),
+        needed_for="Bailey itself",
+        required=True,
+        fix="" if ok else "Install Python 3.11 or newer, or start Bailey with `uvx`, which fetches one.",
+    )
+
+
+def _without_sqlite(name: str, needed_for: str, *, required: bool) -> Check:
+    return Check(
+        name=name,
+        ok=False,
+        found="this Python has no sqlite3 module",
+        needed_for=needed_for,
+        required=required,
+        fix="This Python was built without SQLite. " + GET_PYTHON,
+    )
+
+
+def check_full_text_search(connect: Callable[[str], Any] | None = None) -> Check:
+    """FTS5 is the keyword half of document search, and a compile-time option of SQLite."""
+
+    name, needed_for = "SQLite full-text search", "searching your documents by keyword"
+    if connect is None:
+        if sqlite3 is None:
+            return _without_sqlite(name, needed_for, required=True)
+        connect = sqlite3.connect
+    version = sqlite3.sqlite_version if sqlite3 is not None else "unknown"
+    connection = connect(":memory:")
+    try:
+        connection.execute("CREATE VIRTUAL TABLE probe USING fts5(body)")
+        found = f"SQLite {version} with FTS5"
+        ok = True
+    except Exception as error:  # the probe's only question is whether this statement runs
+        found = f"SQLite {version} without FTS5 ({error})"
+        ok = False
+    finally:
+        connection.close()
+    return Check(
+        name=name,
+        ok=ok,
+        found=found,
+        needed_for=needed_for,
+        required=True,
+        fix="" if ok else "This Python's SQLite was built without FTS5. " + GET_PYTHON,
+    )
+
+
+def check_extension_loading(connection_type: type | None = None) -> Check:
+    """The vector index is a SQLite extension, and loading one is also a build option."""
+
+    name, needed_for = "SQLite extensions", "the vector index, which finds passages by meaning rather than by word"
+    if connection_type is None:
+        if sqlite3 is None:
+            return _without_sqlite(name, needed_for, required=False)
+        connection_type = sqlite3.Connection
+    ok = hasattr(connection_type, "enable_load_extension")
+    return Check(
+        name=name,
+        ok=ok,
+        found="can be loaded" if ok else "cannot be loaded",
+        needed_for=needed_for,
+        required=False,
+        fix=""
+        if ok
+        else (
+            "This Python was built without SQLite extension loading (the Python that ships with macOS is one). "
+            "Keyword search still works; for search by meaning, run Bailey on a Python that allows extensions."
+        ),
+    )
+
+
+def check_uv(which: Callable[[str], str | None] = shutil.which) -> Check:
+    path = which("uvx") or which("uv")
+    return Check(
+        name="uv",
+        ok=bool(path),
+        found=path or "not found",
+        needed_for="tools published as Python packages, which start with `uvx`",
+        required=False,
+        fix="" if path else "Install uv: https://docs.astral.sh/uv/getting-started/installation/",
+    )
+
+
+def check_node(which: Callable[[str], str | None] = shutil.which) -> Check:
+    path = which("npx")
+    return Check(
+        name="Node.js",
+        ok=bool(path),
+        found=path or "not found",
+        needed_for="tools published as npm packages, which start with `npx`",
+        required=False,
+        fix="" if path else "Install Node.js, which includes `npx`, if a solution you use has such a tool.",
+    )
+
+
+def check_loopback(socket_factory: Callable[..., socket.socket] = socket.socket) -> Check:
+    """The app is a server on 127.0.0.1. Binding port 0 asks for any free port."""
+
+    try:
+        with socket_factory(socket.AF_INET, socket.SOCK_STREAM) as probe:
+            probe.bind(("127.0.0.1", 0))
+        ok = True
+    except OSError:
+        ok = False
+    return Check(
+        name="Loopback",
+        ok=ok,
+        found="127.0.0.1 is available" if ok else "cannot listen on 127.0.0.1",
+        needed_for="the app's local server, which only this computer can reach",
+        required=True,
+        fix=""
+        if ok
+        else "Something on this machine refuses local connections; a firewall may need to let Python listen on 127.0.0.1.",
+    )
+
+
+def run_checks() -> list[Check]:
+    return [
+        check_python(),
+        check_full_text_search(),
+        check_extension_loading(),
+        check_uv(),
+        check_node(),
+        check_loopback(),
+    ]
+
+
+def ready(checks: Sequence[Check]) -> bool:
+    return all(check.ok for check in checks if check.required)
+
+
+def render(checks: Sequence[Check], *, version: str) -> str:
+    lines = [f"Bailey {version} doctor", ""]
+    for check in checks:
+        mark = "ok" if check.ok else ("FAIL" if check.required else "--")
+        lines.append(f"  {mark:<5}{check.name}: {check.found}")
+        lines.append(f"       needed for {check.needed_for}" + ("" if check.required else " (optional)"))
+        if not check.ok and check.fix:
+            lines.append(f"       {check.fix}")
+    lines.append("")
+    failed = [check.name for check in checks if check.required and not check.ok]
+    optional = [check.name for check in checks if not check.required and not check.ok]
+    if failed:
+        lines.append("This machine is missing what Bailey requires: " + ", ".join(failed) + ".")
+    else:
+        lines.append("This machine has everything Bailey requires.")
+        if optional:
+            lines.append(
+                "Optional and missing: "
+                + ", ".join(optional)
+                + ". They matter only to a solution whose tools use them."
+            )
+    return "\n".join(lines) + "\n"

bailey-0.0.1.dist-info/METADATA

@@ -0,0 +1,80 @@
+Metadata-Version: 2.5
+Name: bailey
+Version: 0.0.1
+Summary: An open-source AI assistant that runs ready-made solutions on your own machine, with your own AI key. This first release ships `bailey doctor`.
+Project-URL: Homepage, https://github.com/sigrix-io/bailey
+Project-URL: Issues, https://github.com/sigrix-io/bailey/issues
+Project-URL: Changelog, https://github.com/sigrix-io/bailey/blob/main/CHANGELOG.md
+Author: Sigrix
+License-Expression: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: agent,agent-skills,ai,assistant,local-first,mcp,rag
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Bailey
+
+An open-source AI assistant that runs ready-made solutions: on your own machine, with your own AI key.
+
+> **Early days.** This is release 0.0.1. It installs one command, `bailey doctor`, which checks that your computer has what the assistant will need. The assistant itself arrives in 0.1.
+
+## What Bailey is for
+
+Getting AI to do one real job reliably is still a project. Someone writes the instructions, connects the tools, supplies the documents and the keys, checks that it works, and keeps it working when something changes.
+
+Bailey runs **solutions** instead: complete, versioned packages for one job, such as answering customer emails, qualifying leads or writing a weekly report. A solution carries its instructions, skills, tools, knowledge and small apps. Bailey installs it in one step and asks only for the keys it needs.
+
+- **Your machine, your key.** It runs locally and opens in your browser, with the AI provider you choose: Anthropic, OpenAI, or any OpenAI-compatible endpoint, local models included.
+- **It asks before it acts.** Every tool is either read or write, and a write tool asks before it runs: once, always for this assistant, or no.
+- **Your documents stay yours.** Files you add are indexed on your computer, and answers cite the passage they came from.
+- **Open formats.** Skills are Agent Skills, tools are MCP servers, apps speak [Postern](https://github.com/sigrix-io/postern), and a solution is an Agent Plugins folder, so its parts also load in other clients.
+- **No telemetry.**
+
+Solutions can be free, or bought on [Sigrix](https://sigrix.io), where builders sell what they make for Bailey.
+
+## Check your machine
+
+```sh
+uvx bailey doctor
+```
+
+`pipx run bailey doctor` works as well. It checks, and says how to fix what is missing:
+
+| Check | Why Bailey needs it | Required |
+| --- | --- | --- |
+| Python 3.11 or newer | Bailey itself | yes |
+| SQLite with full-text search (FTS5) | searching your documents by keyword | yes |
+| A loopback address | the app's local server, which only this computer can reach | yes |
+| SQLite extension loading | the vector index, which finds passages by meaning | no |
+| uv | tools published as Python packages, which start with `uvx` | no |
+| Node.js | tools published as npm packages, which start with `npx` | no |
+
+It exits 1 when a required check fails, and `bailey doctor --json` prints the same answers for a script. It reads your machine only: no network call, no file written.
+
+## What comes next
+
+- **0.1: the app.** Chat, assistants, skills loaded when needed, tools with approval, knowledge from your own documents with citations, apps, and installing a solution from a file.
+- **0.2: the store.** Sign in, browse, install and update solutions, and publish your own.
+
+## Development
+
+```sh
+pip install -e ".[dev]"
+ruff check . && ruff format --check . && pytest
+```
+
+## Licence
+
+Apache-2.0. The Sigrix name and logo are not covered by the licence; see `NOTICE`.

bailey-0.0.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+bailey/__init__.py,sha256=7N0Gff18GPsJqCvMMuhxwLRSCubD0tjSyeQdAXMRR6E,526
+bailey/__main__.py,sha256=zJXwS9vNn6hiV0DoKoTikW9FkjKHD4gtDsV02oXCEPg,119
+bailey/cli.py,sha256=aO2L8YRJdvfxrgUalE6Ozb87J9khOn7yVVTiWefwuVY,1502
+bailey/doctor.py,sha256=SA5X-D-o38o5rMwSSK-_xaEyz7fhZnnyt8dBnUct-HQ,7153
+bailey-0.0.1.dist-info/METADATA,sha256=hdALsSiQbIgYg_wmDhp1Cf0mZu8nqPd3UF5ZgubkT2w,4064
+bailey-0.0.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+bailey-0.0.1.dist-info/entry_points.txt,sha256=DHkxioHeXh5bnQKIJIIZcPlFhZD9JlHS_abM5-gHZCs,43
+bailey-0.0.1.dist-info/licenses/LICENSE,sha256=oHcgULuYGIbHR4QEnAgN4_coCdJLwrsNUQ6_TGdOHEk,11336
+bailey-0.0.1.dist-info/licenses/NOTICE,sha256=Uc08NlnedaPO35UGqkTmzvu6aKJz7k7-cm4Od3xApnY,320
+bailey-0.0.1.dist-info/RECORD,,

bailey-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

bailey-0.0.1.dist-info/entry_points.txt

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

bailey-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Sigrix
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

bailey-0.0.1.dist-info/licenses/NOTICE

@@ -0,0 +1,8 @@
+Bailey
+Copyright 2026 Sigrix
+
+This product is licensed under the Apache License, Version 2.0 (see LICENSE).
+
+Trademarks. "Sigrix" and the Sigrix logo are trademarks of Sigrix. The Apache
+License does not grant permission to use them. A fork or a derived work must
+not present itself as Sigrix or as published by Sigrix.