semvec/pypi-packages huggingface dataset:
cccc-sdk 0.4.0
Client SDK for the CCCC daemon (IPC v1)
Requires Python: >=3.9
Keywords: cccc, sdk, ipc, agents

# CCCC Python SDK

This package is the **Python client SDK** for CCCC daemon (Daemon IPC v1).

## Relationship to CCCC core

- CCCC core repository: https://github.com/ChesterRa/cccc
- `cccc` core owns daemon/web/CLI and runtime state under `CCCC_HOME`.
- `cccc-sdk` provides client APIs only and must connect to a running daemon.

It requires a running CCCC daemon. The SDK does **not** ship a daemon.

## Versioning

This SDK tracks **CCCC major/minor** (`0.4.x`), while patch/RC cadence is SDK-owned:
- Stable example: `cccc-sdk==0.4.0` with `cccc==0.4.x`
- RC preview example: `cccc-sdk==0.4.1rc1` with `cccc==0.4.x`

## Daemon endpoint discovery

The SDK connects to the daemon endpoint described by:

- `${CCCC_HOME}/daemon/ccccd.addr.json` (preferred, cross-platform), or
- `${CCCC_HOME}/daemon/ccccd.sock` (POSIX AF_UNIX fallback)

## Install

### Stable (PyPI)

```bash
pip install -U cccc-sdk
```

### RC preview (optional, TestPyPI first)

```bash
pip install -U --pre --index-url https://pypi.org/simple \
  --extra-index-url https://test.pypi.org/simple \
  cccc-sdk
```

### From source (development)

```bash
pip install -e .
```

## Usage

```bash
python - <<'PY'
from cccc_sdk import CCCCClient

c = CCCCClient()
c.assert_compatible(require_ipc_v=1, require_capabilities={"events_stream": True})

groups = c.groups()
print(groups)
PY
```

## Examples (repo)

This repository includes runnable examples under `python/examples/`:

```bash
python examples/compat_check.py
```

Stream events for a group:

```bash
python examples/stream.py --group g_xxx
```

Send a message:

```bash
python examples/send.py --group g_xxx --text "hello"
```

Auto-ACK attention messages (as a recipient):

```bash
python examples/auto_ack_attention.py --group g_xxx --actor user
```

Add a note to shared context:

```bash
python examples/context_add_note.py --group g_xxx --content "remember to do X"
```

Cross-group send:

```bash
python examples/send_cross_group.py --src g_src --dst g_dst --text "hello from src"
```
uninstall-dot 1.1.0
Uninstall .
Requires Python: >=3.10

# uninstall-dot

Uninstall local projects by directory.

`uninstall-dot` forwards arguments to pip. If the `uninstall` subcommand is used
with a directory argument then the project name is looked up. Works with any project that includes
[PEP 610](https://peps.python.org/pep-0610/) URL origin in the installed package. If the URL origin
is not available then [PEP 621](https://peps.python.org/pep-0621/) projects can still be uninstalled
by looking up the project name in the pyproject.toml.

## install + setup

```bash
pip install uninstall-dot
alias pip=uninstall-dot
```

## motivation

So often I type `pip install .` that sometimes I mistakenly assume that `pip uninstall .` should
also work. `uninstall-dot` corrects my mistakes and brings symmetry to my life.