Metadata-Version: 2.4
Name: crowe-logic
Version: 0.9.8
Summary: Crowe Logic. The agent console for the terminal: routed model tiers, named engines, a real tool loop.
Author-email: Michael Crowe <michael@crowelogic.com>
Maintainer-email: Michael Crowe <michael@crowelogic.com>
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://crowelogic.com/foundry/
Project-URL: Release notes, https://pypi.org/project/crowe-logic/#history
Keywords: agent-console,terminal,cli,crowelm,tool-calling,mycology
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: azure-ai-agents>=1.1.0
Requires-Dist: azure-identity>=1.25.0
Requires-Dist: azure-ai-projects>=2.0.0
Requires-Dist: anthropic>=0.40.0
Requires-Dist: click>=8.1.0
Requires-Dist: rich>=14.0.0
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: openai>=1.0.0
Requires-Dist: httpx>=0.28.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: wcwidth>=0.2.13
Requires-Dist: textual>=1.0
Requires-Dist: fastapi>=0.110.0
Requires-Dist: uvicorn[standard]>=0.30.0
Provides-Extra: quantum
Requires-Dist: crowe-quantum-trinity>=2.0.0; extra == "quantum"
Requires-Dist: qiskit>=1.0.0; extra == "quantum"
Requires-Dist: qiskit-aer>=0.15.0; extra == "quantum"
Requires-Dist: qiskit-ibm-runtime>=0.35.0; extra == "quantum"
Requires-Dist: cirq>=1.4.0; extra == "quantum"
Requires-Dist: pennylane>=0.39.0; extra == "quantum"
Provides-Extra: nvidia
Requires-Dist: nvidia-cuda-runtime-cu12; extra == "nvidia"
Requires-Dist: cupy-cuda12x; extra == "nvidia"
Provides-Extra: studio-vision
Requires-Dist: torch>=2.2; extra == "studio-vision"
Requires-Dist: transformers>=4.44; extra == "studio-vision"
Requires-Dist: Pillow>=10.0; extra == "studio-vision"
Requires-Dist: scikit-learn>=1.4; extra == "studio-vision"
Requires-Dist: joblib>=1.3; extra == "studio-vision"
Provides-Extra: mcp
Requires-Dist: mcp<2,>=1.0; extra == "mcp"
Provides-Extra: all
Requires-Dist: crowe-logic[mcp,nvidia,quantum,studio-vision]; extra == "all"
Dynamic: license-file

# Crowe Logic

The agent console for the terminal. One command, a real tool loop, and a
model table that names the engine beside every tier.

`crowe` runs as an interactive console or as a single prompt. It carries its
own tool registry, reads and edits files, runs shell commands under an
autonomy level you set, searches the web, and streams reasoning as it works.
The first run needs no card and no keys: an anonymous device token puts you on
CroweLM Mycelium, the cultivation model Crowe Logic trained, at twenty turns a
day. Signing in with Crowe ID opens the rest of the table. The console checks
for updates once a day and installs them itself; `crowe update` any time.

Proprietary software, licensed not sold. See LICENSE. Python 3.10 or newer on
macOS, Linux or Windows.

## Install

```bash
pip install crowe-logic
```

This installs two commands, `crowe` and `crowe-logic`, which are the same
program; the long name stays so nothing installed before the rename breaks.
An npm wrapper exists for Node shops and runs the same pip install for you:

```bash
npm i -g crowe-logic
```

## First run

```bash
crowe                # the console, on the free tier
crowe login          # sign in with Crowe ID; paid tiers appear in /model
crowe run "prompt"   # one prompt, one answer, exit
```

Inside a session the five commands a new user needs are `/model`, `/effort`,
`/autonomy`, `/tools` and `/help`.

## Models

`/model` lists every tier with the engine it runs on, grouped:

| Tier | Runs on | Notes |
|---|---|---|
| CroweLM Auto | routes per turn | The default. Reads the task and picks a family. |
| CroweLM | Claude Fable 5 by Anthropic | Where a turn starts. Three effort rungs. |
| CroweLM Zenith | Claude Opus 5 by Anthropic | Decisive analysis. The other half of dual mode. |
| CroweLM Depth | Grok 4.6 by xAI | Long-horizon work over very large contexts. |
| CroweLM Flash | DeepSeek V4 Flash | Drafts and tight iteration. Lowest cost per turn. |
| CroweLM Coder | GPT-5.6 by OpenAI | Code in your codebase. |
| CroweLM Vision, Grower, Kernel | Claude Fable 5 | Personas: images, cultivation operations, systems work. |
| GPT-5.5, GPT-5.4, DeepSeek V4 Pro, Kimi K2.7 Code, Kimi K3, GLM 5.3 Flash, Claude Opus 4.8 | themselves | Frontier picks, offered by name on your own inference keys. No CroweLM identity. |
| CroweLM Mycelium | Crowe Mycelium (Gemma 4 fine-tune) | The free tier. The model Crowe trained. |
| DeepParallel, Nemotron Nano and Super | multi-provider council; NVIDIA NIM | Backstops. |

Pick by number or name (`/model zenith`, `/model 2`). `/effort normal|high|max`
moves within a family. Crowe Logic does not train the frontier engines; what
makes a tier CroweLM is the routing, the grounding in Crowe's knowledge base,
the tools and the orchestration on top. Ask any tier what it runs on and it
answers plainly. The tier names stay put when an engine moves, so your pins
and scripts do not have to.

## Sign-in and plans

The CroweLM tiers run through your Crowe ID at id.crowelogic.com. The free
tier has no card and no keys. Pro is $99 a month for the whole table, every
effort rung, dual mode and synthesis, and the desktop and web apps on the same
sign-in. `crowe upgrade` opens checkout; `crowe billing` opens the customer
portal; `crowe whoami` shows the signed-in identity and tier.

The frontier picks and any self-hosted endpoint run on keys you hold:
`crowe init --node` writes the env template.

## Usage

```bash
crowe                # interactive console (default)
crowe run "prompt"   # one prompt, one answer, exit
crowe login          # sign in with Crowe ID
crowe whoami         # signed-in identity and tier
crowe upgrade        # open Pro checkout
crowe billing        # open the customer portal
crowe doctor         # check the install and its connections
crowe tools          # list the tool registry
crowe update         # update now (the console also does this daily)
```

## Bring your own keys

The CroweLM tiers need only your Crowe ID. The frontier picks, and any
endpoint you host yourself, run on keys you hold. `crowe init --node` writes
`~/.crowe-logic.env` with the variables below; fill in the ones you use.

| Variable | Purpose |
|---|---|
| `CROWE_LOGIC_GATEWAY_URL` | The Crowe Logic gateway; defaults to `https://api.crowelogic.com` |
| `CROWE_ID_ISSUER` | The Crowe ID issuer; defaults to `https://id.crowelogic.com/realms/crowe` |
| `CROWE_LOGIC_AUTO_ROUTE` | `1` lets CroweLM Auto resolve to a live tier per turn on a self-managed node |
| `AZURE_CORE_ENDPOINT`, `AZURE_CORE_API_KEY` | Your own Azure inference endpoint and key |
| `CROWE_OPEN_ENDPOINT`, `CROWE_OPEN_API_KEY` | Any OpenAI-compatible endpoint you host |
| `NVIDIA_NIM_ENDPOINT`, `NVIDIA_API_KEY` | NVIDIA NIM, for the Nemotron backstops |
| `CROWE_LOGIC_HOME` | Where the console keeps per-user state; defaults to `~/.crowe-logic` |
| `CROWE_LOGIC_TELEMETRY` | `0` turns off the local telemetry file described below |

Extra model entries load from `CROWE_LOGIC_EXTRA_MODELS_JSON`,
`CROWE_LOGIC_EXTRA_MODELS_PATH`, or `~/.config/crowe-logic/models.extra.json`.

## MCP server

The Crowe Logic platform is also available as a standalone MCP server for any
MCP client:

```bash
uvx crowe-logic-mcp
```

The bundled `crowe-logic-quantum-mcp` server needs the `mcp` extra:

```bash
pip install "crowe-logic[mcp]"
```

## Specialized agents

| Agent | Focus |
|-------|-------|
| `cultivation` | Mushroom cultivation with the Crowe knowledge base |
| `quantum` | Quantum computing with QubitFlow + Synapse + Trinity bridge |
| `music` | Music composition with the Talon engine |
| `code` | General software development |
| `research` | Web research and analysis |

## Local telemetry

Crowe keeps a local record of what the console did: which tools ran and how long
they took, which tier and provider answered, token counts, timings, and session
events. It does not keep your prompts, the replies, or the contents of your files.
Tool arguments are cut to 200 characters, and the values of `content`, `text`, and
`data` arguments are dropped, with only their lengths recorded.

The record is a JSON-lines file at `~/.crowe-logic/runtime/telemetry.jsonl`, created
with owner-only permissions and rotated at 50 MB. It stays on your machine; the
console never uploads it. Nothing is written until the first event, so
`crowe --version` touches nothing under your home directory. To turn it off, set
`CROWE_LOGIC_TELEMETRY=0` (`false`, `no`, and `off` also work).

## Requirements

- Python 3.10 or newer on macOS, Linux or Windows.
- A Crowe ID for the paid tiers; nothing for the free tier.

## Author

Michael Crowe, [Crowe Logic, Inc.](https://crowelogic.com)

## License

Proprietary. Copyright (c) 2026 Crowe Logic, Inc. All rights reserved.
See the LICENSE file for terms. Licensed, not sold: use requires the no-cost
tier or a current paid plan, and redistribution is not permitted.

Releases before 0.7.1 shipped an Apache License 2.0 text and were distributed
under it; this change is not retroactive.

Licensing questions: michael@crowelogic.com
