Metadata-Version: 2.5
Name: biocognia-intelligence
Version: 0.2.0
Summary: Biocognia Intelligence: one AI workspace over the BioCognia products installed, opened with `biocognia`
Project-URL: Homepage, https://biocognia.com
Author-email: Ajit Johnson Nirmal <ajitjohnson.n@gmail.com>
License-Expression: LicenseRef-Proprietary
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Python: >=3.12
Requires-Dist: biocognia<0.2,>=0.1.2
Requires-Dist: spatialagents<0.3,>=0.2.2
Requires-Dist: spatialbridge[mcp]<0.3,>=0.2.2
Provides-Extra: plexora
Requires-Dist: plexora[ai,bridge]>=0.0.32; extra == 'plexora'
Provides-Extra: scimappro
Requires-Dist: scimappro[ai,bridge,chat]; extra == 'scimappro'
Description-Content-Type: text/markdown

# Biocognia Intelligence

One AI workspace over the BioCognia products you have installed, opened with one command:

```bash
pip install "biocognia-intelligence[scimappro,plexora]"
biocognia
```

`biocognia` opens the Workspace in your browser. Start with your data: a file, a
folder, or a data location. The product that fits it opens it (or the one you
choose), and the assistant helps you explore and interpret it. Your workspaces
from each product are listed together. The products you have installed, such
as Plexora, can be opened from the home screen in their own windows.

One conversation can use several products. In a SCIMAP Pro workspace with
Plexora installed, the assistant can also gate markers against the staining,
check the image's quality and draw regions in Plexora, and bring the results
back into the table.

| Command | What it does |
|---|---|
| `biocognia` | Opens the app. `--no-browser` prints its address instead, `--port` serves elsewhere (default 8480), and `--home ID` sets the product a new workspace belongs to. |
| `biocognia list` | The products installed. `--licence` adds whether each one's AI licence lets a conversation run, and `--json` prints it all as JSON. |
| `biocognia open plexora` | Opens a product's own application. |
| `biocognia license status` | This device's licences, for every product. `activate`, `refresh`, `install` and the other verbs work as in each product's own command line. |
| `biocognia serve --desktop` | A desktop shell's sidecar: one ready line, then the app until stdin closes. |

## How it is put together

- **A workspace belongs to one product**, its home. It is stored where that
  product keeps its sessions, so the product's own app (`scimappro`) lists and
  opens the same workspaces.
- **The home product pays.** Its AI licence pays for the conversation, through
  that product's own gateway. There is no separate Intelligence licence: AI
  comes with each product's licence.
- **Other products join as guests.** A guest's tools are listed in the
  conversation as `<product>.<tool>`, from a manifest shipped with the product,
  so the conversation's catalogue does not change when the guest is not
  running. Each call goes over [spatialbridge](https://pypi.org/project/spatialbridge/)
  to the copy already running, or starts one. The guest checks the call against its own licence.
  Guests offer reads and reversible writes only, because the bridge cannot
  carry an approval. The home's own hand-offs, such as SCIMAP Pro's `view_image`,
  still move data between products, and the guest tools they already drive are
  not offered a second time.
- **The runtime is shared.** The conversation, plans, approvals and the page are
  [spatialagents](https://pypi.org/project/spatialagents/). Licences and the
  AI token come from [biocognia](https://pypi.org/project/biocognia/).
- **Products register themselves.** A product joins by registering one object
  under the `biocognia.products` entry point, from a package small enough to
  import in a moment. The contract is in `src/biocognia_intelligence/registry.py`.

```toml
[project.entry-points."biocognia.products"]
myproduct = "myproduct_intelligence:PRODUCT"
```
