semvec/pypi-packages huggingface dataset:
llmb-flagship 0.1.3
CLI tool for standardized init and deploy of AgentCore-based MCP server deployments
License: MIT
Requires Python: >=3.11
Keywords: agentcore, aws, cdk, cli, llmb-flagship, mcp

# llmb-flagship

CLI tool for standardized **init and deploy** of AgentCore-based MCP server deployments.

Distributed via **PyPI** as `llmb-flagship`. Runtime commands are gated by Entra (Azure AD) authentication.

## Prerequisites

- Python 3.11+
- `uv` installed ([docs.astral.sh/uv](https://docs.astral.sh/uv/))

## Installation

```bash
uv tool install llmb-flagship
```

## Quick start

```bash
llmb-flagship init             # Authenticate with Entra + save config
llmb-flagship hello            # Smoke-test
```

`llmb-flagship init` opens the browser for Entra login and stores credentials locally at `~/.llmb-flagship/`.

## Commands

| Command                   | Auth required | Description                                      |
| ------------------------- | ------------- | ------------------------------------------------ |
| `llmb-flagship hello`     | No            | Smoke-test — prints "hello world"                |
| `llmb-flagship init`      | Yes (prompts) | Authenticate with Entra, save config             |
| `llmb-flagship --version` | No            | Print version                                    |
| `llmb-flagship deploy`    | Yes           | Deploy AgentCore stacks *(coming soon)*          |

## Development

```bash
cd llmb-cli
uv sync --group dev
uv run llmb-flagship hello
uv run llmb-flagship init
```

## Publishing

### CI (GitLab — Trusted Publishing)

Pushing a Git tag matching `v*.*.*` triggers the publish pipeline via OIDC trusted publishing. See `.gitlab-ci.yml`.

```bash
git add .
git commit -m "release v0.1.1"
git tag v0.1.1
git push origin main --tags
```

- Code is always on `main` — visible to everyone in the repo.
- GitLab CI runs **lint + test** on every push to `main`, and additionally runs **publish** when it detects a `v*.*.*` tag.

## Reference

Based on the canonical `agentcore-mcp-demo` pattern from [llm-backbone-samples](https://gitlab.com/flagship-informatics/pioneering-intelligence/projects/llm-backbone/llm-backbone-samples).