Skip to main content

apeSketch

Hand-ink bridge for the ape* structural toolchain.

apeSketch is a standalone Python library. It records freehand sketches (drawing tablet or Wi-Fi client), keeps a Session Document as source of truth, and exports for agents and later apeCAD.

This repository is public (MIT). Status: pre-alpha — architecture under AProjects/; prototype P0/P1 started.

Locked decisions

ADR Decision
0002 Ink bridge, not a whiteboard product
0003 Python Document; clients emit Ops
0004 LAN Session host; Wi-Fi Direct deferred
0005 Own core; adopt patterns / small MIT deps

Installation

pip install apeSketch

Then start a Session host:

python -m apeSketch

Opens a board on port 9966 (HTTP) with WebSocket on 9967 (apeCAD uses 8765 — these stay separate). Pair page: /pair. Phone on the same Wi‑Fi can open the advertised board URL.

HTTP-only (no WebSocket):

python -m apeSketch --http-only

From this checkout (shared OpenSees toolchain venv):

C:\Users\nmb\venv\opensees_env\Scripts\python.exe -m pip install -e ".[dev]"
C:\Users\nmb\venv\opensees_env\Scripts\python.exe -m pytest
C:\Users\nmb\venv\opensees_env\Scripts\python.exe -m apeSketch

Do not rely on apeSketch’s local .venv for day-to-day work; keep deps in opensees_env.

Layout

AProjects/           ADRs, memory, specs
src/apeSketch/       public Python package
  document.py        ink Document
  ops.py             typed Ops
  session.py         SketchSession
  host/              LAN HTTP + WS + static board
tests/

Prototype plan

See AProjects/specs/prototype.md.

Metadata

Release files for apeSketch 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for apeSketch 0.1.0
File Size Uploaded Provenance Actions
apesketch-0.1.0.tar.gz 71.2 kB With provenance Details for apesketch-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for apeSketch 0.1.0
File Interpreter ABI Platform Actions
apesketch-0.1.0-py3-none-any.whl Python 3 none any Details for apesketch-0.1.0-py3-none-any.whl

Total release size: 141.6 kB

Release files / apesketch-0.1.0.tar.gz

Download URL apesketch-0.1.0.tar.gz
Size 71.2 kB
Tags Source
SHA-256 checksum
How to use checksums
3b06fa0d341d59a4c6f80b81fd087685f3740e8bfb35fb52831f841f77e193f5
BLAKE2b-256 checksum
How to use checksums
0f4ac615de1eff99bf1cba08ff07b41effb701f4c48827ce675e2f48ac106c43
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.

Transparency log

Release files / apesketch-0.1.0-py3-none-any.whl

Download URL apesketch-0.1.0-py3-none-any.whl
Size 70.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8612ef4c8142bf596fe0909de8ef0ad35b1f952e1d3d3b065ef5425fb6a5bf6a
BLAKE2b-256 checksum
How to use checksums
6fe616b9dac5d49323152433a4b6980d114822d2086038ed8635dd3dcad53450
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.

Transparency log

Security for apeSketch 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for apesketch-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page