semvec/pypi-packages huggingface dataset:
nerdd-link 0.5.17
Run a NERDD module as a service
Keywords: science, research, development, nerdd

# NERDD-Link

Run a [NERDD module](https://github.com/molinfo-vienna/nerdd-module) as a  
service that consumes input molecules and produces prediction tuples.


## Installation

```bash
pip install -U nerdd-link
```
  
## Usage

When a class inherits from ```nerdd_module.AbstractModel``` (see 
[NERDD Module Github page](https://github.com/molinfo-vienna/nerdd-module)), it can be 
used to create a Kafka service. 

```bash 
# run a Kafka service for NerddModel on localhost:9092
run_nerdd_server package.path.to.NerddModel

# modify broker url, input topic and batch size
run_nerdd_server package.path.to.NerddModel \
  --broker-url my-cluster-kafka-bootstrap.kafka:9092 \
  --input-topic examples \
  --batch-size 10

# more information via --help
run_nerdd_server --help
```

If the model class is called ```ExamplePredictionModel```, the server will read input 
tuples from the input topic ```example-prediction-inputs``` in batches of size 100
and write results to the ```results``` topic. The batch size specifies the number
of input tuples that are given to the model at once.

## Communication
blackfish-ai 0.5.1
An open-source AI-as-a-Service platform.
Requires Python: >=3.12

# Blackfish AI

Python package `blackfish-ai` - the core backend for the [Blackfish](../) MLaaS platform.

For project overview, installation, and usage instructions, see the [main README](../README.md).

## Development Setup

```bash
cd lib
uv sync                    # Install dependencies
uv run blackfish --help    # Verify CLI works
```

## Common Commands

```bash
# Development (using justfile)
uv run just test           # Run tests with coverage
uv run just lint           # Lint and format
uv run just coverage       # Generate coverage badge
uv run just docs           # Build documentation

# Database Migrations
uv run alembic revision --autogenerate -m "description"
uv run alembic upgrade head
```

## Project Structure

```
lib/
├── src/blackfish/
│   ├── cli/              # CLI commands (rich-click)
│   ├── server/           # Litestar app, routes, models
│   └── build/            # Built frontend (generated)
├── tests/                # pytest tests
└── docs/                 # MkDocs documentation
```

## Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `BLACKFISH_HOST` | Server host | `localhost` |
| `BLACKFISH_PORT` | Server port | `8000` |
| `BLACKFISH_DEBUG` | Enable debug mode (0/1) | `1` |
| `BLACKFISH_HOME_DIR` | Blackfish home directory | `~/.blackfish` |
| `BLACKFISH_BASE_PATH` | API base path | `/` |
| `BLACKFISH_STATIC_DIR` | Static files directory | (bundled) |
| `BLACKFISH_CONTAINER_PROVIDER` | Container provider | (auto-detect) |
| `BLACKFISH_MAX_FILE_SIZE` | Max upload file size | `1000000000` |

## Documentation

- [Full Documentation](https://princeton-ddss.github.io/blackfish/)
- [Main README](../README.md)