abstract-serve
The provider-neutral shared Serve console. It owns the durable conversation store, queue/hold contract, session picker, and provider adapters. Claude, GPT, Hugpy, and local-model packages may provide adapters without owning the Serve runtime.
Run abstract-serve --no-browser to start the console.
pip install abstract-serve-core
abstract-serve --no-browser # standalone
abstract-claude serve # provider package entry point
abstract-gpt serve # same routes, GPT seat installed
Part of the hugpy orbit
┌──────────────────────────── hugpy (fleet) ───────────────────────────┐
│ central + workers: platform · engine · fleet · server · media · … │
│ OpenAI-compatible /v1 — every local model, incl. B (Qwen3-Coder-Next) │
└───────▲───────────────────────▲──────────────────────────▲───────────┘
│ inference │ inference │ B reductions
┌────────────────────────┴──┐ ┌────────────────┴──────────┐ ┌───────────┴───────────────┐
│ hugpy-station │ │ hugpy-agent │ │ abstract-toolserver │
│ desktop + headless console│──▶│ agent runtime · TUI · │◀─▶│ comms · ledgers · boards ·│
│ tmux seats per locus │ │ OpenCode/qwen seats │ │ exchanges · MCP · b_ask │
└────────────┬──────────────┘ └────────────┬──────────────┘ └───────────▲───────────────┘
│ keeper/codex seats │ --serve │ tools (MCP/HTTP)
┌────────────▼──────────────┐ ┌────────────▼──────────────┐ │
│ abstract-gpt (Codex seat) │ │ abstract-claude serve ────┼───────────────┘
│ abstract-claude (Claude) │ │ └ abstract-serve-core │
└───────────────────────────┘ └───────────────────────────┘
everything ships through abstract-pypit → PyPI (+ GitHub)
| Package | Role | PyPI |
|---|---|---|
| hugpy (14 lockstep dists) | the self-hosted LLM fleet: central, workers, engine, media, server | hugpy |
| hugpy-station | Electron desktop + headless backend; tmux seats, prompt composer, loop/bug scan | deb via central install links |
| hugpy-agent | agent runtime on the fleet; hugpy-agent tui over the shared Serve API |
hugpy-agent |
| abstract-claude | Claude Code launch/session/rollover + abstract-claude serve (roles keeper/chat/worker/local) |
abstract-claude |
| abstract-serve-core | provider-neutral HTTP routes (queue, relay, rollover sweeps, session API) | abstract-serve-core |
| abstract-gpt | Codex/ChatGPT seat counterpart of abstract-claude | abstract-gpt |
| abstract-toolserver | one tool service per host: comms, ledgers, boards, exchanges, MCP bridge, B on call | abstract-toolserver |
| abstract-pypit | one-command publisher: bump → build → PyPI → GitHub push | abstract-pypit |
What it owns
Provider CLI entry points execute the shared HTTP routes in
abstract_serve_core/console/server.py. Shared Serve behaviour is implemented
here and imported directly by provider packages. Its
GET /api/state advertises service=abstract-serve and protocol version 1;
clients should identify this API independently of the configured model provider.
- Roles:
keeper,chat,worker,localare standing serve sessions recorded inroster.json— not Claude sessions. Send to one withPOST /api/session/<role>/message. - Cross-locus relay:
session_message/ relay acceptsto="<locus>"orto="<locus>:keeper";relay.send_crossposts a comms ping board row on the target locus tagged[from <locus>:<role>], answers202 queued, and logs torelay.jsonl. Non-keeper cross-locus targets are refused (400). - Queue: queue-first collator; prompts are sent verbatim —
_compile_prompt()only dedups and joins, never runs a model. A model merge exists only as an explicit preview (POST /api/compile {suggest:true}) the operator must apply. - Interrupt = stop (0.1.16): an interrupted batch is done, never retried, never held; queued items drain at the end of the turn.
- Directives:
AC_SESSION_DIRECTIVES_DIR/<role>.mdis appended to every turn of that role. - Rollover sweeps measure context per session (including gpt sessions via the codex rollout) and roll over near the limit.
- Seat report: a sidecar publishes
{surface: serve, port, pid}to the centralseat_state. AC_LOCAL_LLM_URLpoints at the local model (B) used for previews.
Attention-worthy
[rollover] sweep #Nlog lines are routine, not errors (Station's bug scan ignores them since 1.0.152).- Republishing the same version needs
pip install --force-reinstall, or the old files stay. - Token counters are blank for sessions served by the hugpy engine — it emits no per-turn usage.
Changelog
See CHANGELOG.md (0.1.15: verbatim prompts, gpt runaway guard; 0.1.16:
interrupt = stop).
Python package layout
The package root holds its CLI entry points, version, and packaged assets. Implementations are grouped by responsibility:
| Subpackage | Modules |
|---|---|
accounting/ |
pricing.py, token_test.py, usage_db.py |
catalog/ |
models.py |
configuration/ |
actions.py, cfgdir.py, credentials.py, paths.py |
console/ |
attachments.py, console_service.py, hub.py, providers.py, server.py, webui_assets.py |
integrations/ |
mcp.py, relay.py, toolset.py |
mct/ |
mct_archive.py, mct_repl.py |
processes/ |
auth_capture.py, clis.py, keepalive.py, launch.py, seat_report.py |
sessions/ |
chrono.py, queue.py, rollover.py, roster.py, session_keys.py, session_roll.py, stepcap.py |
support/ |
reduce.py, util.py |
Import implementations directly from these subpackages. The former flat module aliases have been removed; shared Claude and GPT helpers live in abstract_serve_core and callers import them there. Console provider discovery continues to use the abstract_serve_core.providers metadata group, with targets in abstract_serve_core.console.providers.
The former abstract_serve Python namespace has been removed. Web assets remain in abstract_serve_core/webui/.
Metadata
Release files for abstract-serve-core 0.1.35
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| abstract_serve_core-0.1.35.tar.gz | 434.1 kB | Without provenance | Details for abstract_serve_core-0.1.35.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| abstract_serve_core-0.1.35-py3-none-any.whl | Python 3 | none | any | Details for abstract_serve_core-0.1.35-py3-none-any.whl |
Total release size: 819.9 kB
Release files / abstract_serve_core-0.1.35.tar.gz
| Download URL | abstract_serve_core-0.1.35.tar.gz |
|---|---|
| Size | 434.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a5ee7a0aef187087ec19c7a0bd289725b966e46001697a4114ccc94108662a83
|
|
BLAKE2b-256 checksum How to use checksums |
92796bd7eb1304eb43ccad6764be099f3c180e14a17e68cb8affcd69bdde1165
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / abstract_serve_core-0.1.35-py3-none-any.whl
| Download URL | abstract_serve_core-0.1.35-py3-none-any.whl |
|---|---|
| Size | 385.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
abd510fd0934c276376d96df9eacda3aa812a4e365d3ab87c2e0e6acd5ef6c2b
|
|
BLAKE2b-256 checksum How to use checksums |
77c257c4838b8a0870234c6a3cd54b953354ab55f761a0e2649b0d81a7153f91
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Security for abstract-serve-core 0.1.35
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.