twoody 0.2.0__tar.gz

twoody-0.2.0/.gitignore

@@ -0,0 +1,5 @@
+dist/
+build/
+*.egg-info/
+__pycache__/
+.venv/

twoody-0.2.0/LICENSE

@@ -0,0 +1,11 @@
+Copyright (c) 2026 Osmove SASU. All rights reserved.
+
+Osmove lets you install and use this software free of charge, for personal
+and professional purposes alike, including in your company or practice,
+under the terms of use of Twoody: https://www.twoody.com/terms
+
+You may not sell or rent it, or present it as your own. No other right is
+granted.
+
+It is built with free software, including llama.cpp (MIT licence), whose
+licences ship with it.

twoody-0.2.0/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.5
+Name: twoody
+Version: 0.2.0
+Summary: Twoody from the command line: run this computer's models (`twoody run`, `pull`, `list`), an OpenAI-compatible local API, chat, and `twoody serve`; the same command as `npm install -g twoody`, needs Node.js 22+
+Project-URL: Homepage, https://twoody.com
+Author-email: Osmove <support@twoody.com>
+License-Expression: LicenseRef-Twoody
+License-File: LICENSE
+Keywords: assistant,llama.cpp,llm,local-llm,ollama,openai-compatible,private-ai,raspberry-pi,self-hosted,twoody
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# twoody
+
+Twoody from the command line, on a Mac, a Raspberry Pi 5, a NAS or any
+server: the same `twoody` command as `npm install -g twoody`.
+
+```bash
+pip install twoody       # or: pipx install twoody
+twoody --help
+twoody serve --llm http://127.0.0.1:11434/v1     # start Twoody Server
+twoody setup                                     # create the account
+twoody chat --effort think
+```
+
+With Twoody Desktop (or `twoody serve`) on the computer, the same command runs
+its models and gives programs an OpenAI-compatible API, on this computer only:
+
+```bash
+twoody list                                  # the models here
+twoody run Qwen3.5-9B-Q4_K_M "Bonjour"       # one answer, or a conversation without a prompt
+twoody api-key create "my script"            # a key for http://127.0.0.1:47821/v1
+```
+
+The Twoody CLI is a Node.js program: this package is a small launcher. The
+`twoody` command checks that **Node.js 22 or later** is installed (and says
+how to install it if not), then runs `npx -y twoody@0.2.0` with the same
+arguments; npm downloads the CLI, and Twoody Server with it, once and caches
+it. Set `TWOODY_NPM_VERSION` to run another release (for example `latest`);
+`twoody --launcher-version` prints this launcher's version.
+
+`twoody serve` (alias `twoody server [options]`) starts Twoody Server with its
+options: `--port`, `--host`, `--data-dir`, `--llm`, `--pairing-code`,
+`--local-only`, `--no-bonjour`. The server has no model of its own: run
+[Ollama](https://ollama.com) (`ollama pull qwen3.5:4b`, or a model of your
+choice), llama.cpp's `llama-server` or LM Studio next to it and point `--llm`
+at its OpenAI-compatible `/v1` address. On first start the server prints a
+setup token: `twoody setup` or the Twoody app asks for it to create the
+account.
+
+`twoody ask` and `twoody chat` take the apps' choices: `--effort
+fast|think|deep`, `--model` (`twoody models`), `--documents
+off|all|selected|only` with `--folders` (`twoody folders`).
+
+Without Node.js, use the Docker image for the server
+(`ghcr.io/osmove/twoody-server`, with a compose file that includes Ollama),
+or Homebrew for the CLI (`brew install osmove/twoody/twoody`).
+
+Free to install and use, for personal and professional purposes alike,
+under the terms of use of Twoody (https://www.twoody.com/terms): see
+[LICENSE](LICENSE).

twoody-0.2.0/README.md

@@ -0,0 +1,49 @@
+# twoody
+
+Twoody from the command line, on a Mac, a Raspberry Pi 5, a NAS or any
+server: the same `twoody` command as `npm install -g twoody`.
+
+```bash
+pip install twoody       # or: pipx install twoody
+twoody --help
+twoody serve --llm http://127.0.0.1:11434/v1     # start Twoody Server
+twoody setup                                     # create the account
+twoody chat --effort think
+```
+
+With Twoody Desktop (or `twoody serve`) on the computer, the same command runs
+its models and gives programs an OpenAI-compatible API, on this computer only:
+
+```bash
+twoody list                                  # the models here
+twoody run Qwen3.5-9B-Q4_K_M "Bonjour"       # one answer, or a conversation without a prompt
+twoody api-key create "my script"            # a key for http://127.0.0.1:47821/v1
+```
+
+The Twoody CLI is a Node.js program: this package is a small launcher. The
+`twoody` command checks that **Node.js 22 or later** is installed (and says
+how to install it if not), then runs `npx -y twoody@0.2.0` with the same
+arguments; npm downloads the CLI, and Twoody Server with it, once and caches
+it. Set `TWOODY_NPM_VERSION` to run another release (for example `latest`);
+`twoody --launcher-version` prints this launcher's version.
+
+`twoody serve` (alias `twoody server [options]`) starts Twoody Server with its
+options: `--port`, `--host`, `--data-dir`, `--llm`, `--pairing-code`,
+`--local-only`, `--no-bonjour`. The server has no model of its own: run
+[Ollama](https://ollama.com) (`ollama pull qwen3.5:4b`, or a model of your
+choice), llama.cpp's `llama-server` or LM Studio next to it and point `--llm`
+at its OpenAI-compatible `/v1` address. On first start the server prints a
+setup token: `twoody setup` or the Twoody app asks for it to create the
+account.
+
+`twoody ask` and `twoody chat` take the apps' choices: `--effort
+fast|think|deep`, `--model` (`twoody models`), `--documents
+off|all|selected|only` with `--folders` (`twoody folders`).
+
+Without Node.js, use the Docker image for the server
+(`ghcr.io/osmove/twoody-server`, with a compose file that includes Ollama),
+or Homebrew for the CLI (`brew install osmove/twoody/twoody`).
+
+Free to install and use, for personal and professional purposes alike,
+under the terms of use of Twoody (https://www.twoody.com/terms): see
+[LICENSE](LICENSE).

twoody-0.2.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "twoody"
+version = "0.2.0"
+description = "Twoody from the command line: run this computer's models (`twoody run`, `pull`, `list`), an OpenAI-compatible local API, chat, and `twoody serve`; the same command as `npm install -g twoody`, needs Node.js 22+"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "LicenseRef-Twoody"
+license-files = ["LICENSE"]
+authors = [{ name = "Osmove", email = "support@twoody.com" }]
+keywords = ["twoody", "assistant", "local-llm", "llm", "openai-compatible", "llama.cpp", "ollama", "self-hosted", "raspberry-pi", "private-ai"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: End Users/Desktop",
+  "Operating System :: POSIX :: Linux",
+  "Operating System :: MacOS",
+  "Operating System :: Microsoft :: Windows",
+  "Programming Language :: Python :: 3",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://twoody.com"
+
+[project.scripts]
+twoody = "twoody.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/twoody"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/twoody", "README.md", "LICENSE", "pyproject.toml"]

twoody-0.2.0/src/twoody/__init__.py

@@ -0,0 +1,9 @@
+"""Twoody: the `twoody` command (the `twoody` npm package) through Node.js."""
+
+__version__ = "0.2.0"
+
+# The `twoody` npm release this launcher runs: the Twoody CLI, whose
+# `twoody serve` starts Twoody Server. Pinned, so `pip install twoody==X`
+# always runs the same CLI; TWOODY_NPM_VERSION overrides it (for example
+# "latest").
+NPM_VERSION = "0.2.0"

twoody-0.2.0/src/twoody/__main__.py

@@ -0,0 +1,3 @@
+from twoody.cli import main
+
+raise SystemExit(main())

twoody-0.2.0/src/twoody/cli.py

@@ -0,0 +1,85 @@
+"""The `twoody` command.
+
+The Twoody CLI is a Node.js program published on npm as `twoody`. This
+command checks that Node.js 22 or later is installed, then runs
+`npx -y twoody@<version>` with the arguments it was given: npm downloads the
+CLI (and Twoody Server, which `twoody serve` starts) once and caches it.
+`pip install twoody` and `npm install -g twoody` give the same commands.
+"""
+
+from __future__ import annotations
+
+import os
+import re
+import shutil
+import subprocess
+import sys
+
+from twoody import NPM_VERSION, __version__
+
+MIN_NODE_MAJOR = 22
+
+INSTALL_NODE = f"""Twoody runs on Node.js {MIN_NODE_MAJOR} or later, and {{problem}}.
+
+Install Node.js {MIN_NODE_MAJOR}+ (it comes with npm and npx), then run twoody again:
+  - macOS:            brew install node@{MIN_NODE_MAJOR}   (or https://nodejs.org)
+  - Debian, Ubuntu,
+    Raspberry Pi OS:  curl -fsSL https://deb.nodesource.com/setup_{MIN_NODE_MAJOR}.x | sudo bash -
+                      sudo apt-get install -y nodejs
+  - Windows:          winget install OpenJS.NodeJS.LTS   (or https://nodejs.org)
+
+Or skip Node.js: the Docker image ghcr.io/osmove/twoody-server runs the
+server, and `brew install osmove/twoody/twoody` gives the CLI."""
+
+
+def node_major(node: str) -> int | None:
+    try:
+        out = subprocess.run([node, "--version"], capture_output=True, text=True, timeout=15).stdout
+    except (OSError, subprocess.SubprocessError):
+        return None
+    match = re.match(r"v(\d+)\.", out.strip())
+    return int(match.group(1)) if match else None
+
+
+def npm_version() -> str:
+    return os.environ.get("TWOODY_NPM_VERSION") or NPM_VERSION
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = list(sys.argv[1:] if argv is None else argv)
+
+    # Every argument is the CLI's (`twoody --help`, `twoody serve --llm …`,
+    # `twoody chat`…); only `--launcher-version` is this package's.
+    if args == ["--launcher-version"]:
+        print(f"twoody {__version__} for PyPI (runs twoody@{npm_version()} from npm)")
+        return 0
+
+    node = shutil.which("node")
+    if node is None:
+        print(INSTALL_NODE.format(problem="it is not installed (no `node` on the PATH)"), file=sys.stderr)
+        return 1
+    major = node_major(node)
+    if major is None or major < MIN_NODE_MAJOR:
+        found = f"this one is version {major}" if major is not None else "`node --version` did not answer"
+        print(INSTALL_NODE.format(problem=found), file=sys.stderr)
+        return 1
+    npx = shutil.which("npx")
+    if npx is None:
+        print(INSTALL_NODE.format(problem="npx (installed with npm) is missing"), file=sys.stderr)
+        return 1
+
+    command = [npx, "-y", f"twoody@{npm_version()}", *args]
+
+    if os.name == "posix":
+        # Replace this process: signals from a terminal, systemd or Docker
+        # reach the CLI (and the server `twoody serve` runs) directly, and
+        # its exit code is the command's.
+        os.execv(npx, command)
+    try:
+        return subprocess.call(command)
+    except KeyboardInterrupt:
+        return 130
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())