# darkfield CLI
Command-line interface for the darkfield ML Safety Platform.
## Installation
### For Development
```bash
# From the cli directory
./install-local.sh
```
### For Production (when published)
```bash
pip install darkfield-cli
# or
npm install -g @darkfield/cli
```
## First Run
When you first run darkfield, you'll see:
```
██████╗ █████╗ ██████╗ ██╗ ██╗███████╗██╗███████╗██╗ ██████╗
██╔══██╗██╔══██╗██╔══██╗██║ ██╔╝██╔════╝██║██╔════╝██║ ██╔══██╗
██║ ██║███████║██████╔╝█████╔╝ █████╗ ██║█████╗ ██║ ██║ ██║
██║ ██║██╔══██║██╔══██╗██╔═██╗ ██╔══╝ ██║██╔══╝ ██║ ██║ ██║
██████╔╝██║ ██║██║ ██║██║ ██╗██║ ██║███████╗███████╗██████╔╝
╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚══════╝╚══════╝╚═════╝
ML Safety Platform Command Line Interface
Protecting AI from harmful personas • v0.1.0
```
## Quick Start
```bash
# Authenticate
darkfield auth login
# Run a demo
darkfield analyze demo --trait sycophancy
# Check your usage
darkfield billing usage
```
## Development
```bash
# Install dependencies
pip install -e .
# Run tests
pytest
# Build distribution
python setup.py sdist bdist_wheel
```
## Publishing
```bash
# PyPI
python -m twine upload dist/*
# NPM (wrapper)
npm publish
```
Raw data
{
"_id": null,
"home_page": "https://github.com/darkfield-ai/darkfield-cli",
"name": "darkfield-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "ai, ml, safety, persona-vectors, alignment",
"author": "Darkfield AI",
"author_email": "darkfield <contact@darkfield.ai>",
"download_url": "https://files.pythonhosted.org/packages/4e/19/37e645ce02503eeee6b36b8ad44df77b595334c9abef75976d4d53d50cc4/darkfield_cli-0.1.0.tar.gz",
"platform": null,
"description": "# darkfield CLI\n\nCommand-line interface for the darkfield ML Safety Platform.\n\n## Installation\n\n### For Development\n\n```bash\n# From the cli directory\n./install-local.sh\n```\n\n### For Production (when published)\n\n```bash\npip install darkfield-cli\n# or\nnpm install -g @darkfield/cli\n```\n\n## First Run\n\nWhen you first run darkfield, you'll see:\n\n```\n \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557 \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \n \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551 \u2588\u2588\u2554\u255d\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d\u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\n \u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2588\u2588\u2588\u2554\u255d \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551\n \u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2588\u2588\u2557 \u2588\u2588\u2554\u2550\u2550\u255d \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255d \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551\n \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2557\u2588\u2588\u2551 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\n \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u255d \u255a\u2550\u255d\u255a\u2550\u255d \u255a\u2550\u255d\u255a\u2550\u255d \u255a\u2550\u255d\u255a\u2550\u255d \u255a\u2550\u255d\u255a\u2550\u2550\u2550\u2550\u2550\u2550\u255d\u255a\u2550\u2550\u2550\u2550\u2550\u2550\u255d\u255a\u2550\u2550\u2550\u2550\u2550\u255d \n\n ML Safety Platform Command Line Interface\n Protecting AI from harmful personas \u2022 v0.1.0\n```\n\n## Quick Start\n\n```bash\n# Authenticate\ndarkfield auth login\n\n# Run a demo\ndarkfield analyze demo --trait sycophancy\n\n# Check your usage\ndarkfield billing usage\n```\n\n## Development\n\n```bash\n# Install dependencies\npip install -e .\n\n# Run tests\npytest\n\n# Build distribution\npython setup.py sdist bdist_wheel\n```\n\n## Publishing\n\n```bash\n# PyPI\npython -m twine upload dist/*\n\n# NPM (wrapper)\nnpm publish\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Navigate the topology of mind - ML safety through persona vectors",
"version": "0.1.0",
"project_urls": {
"Documentation": "https://darkfield.ai/docs",
"Homepage": "https://darkfield.ai",
"Issues": "https://github.com/darkfield-ai/darkfield-cli/issues",
"Repository": "https://github.com/darkfield-ai/darkfield-cli"
},
"split_keywords": [
"ai",
" ml",
" safety",
" persona-vectors",
" alignment"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "2d2bbf2f03662b169525f2c6ee7fa2033b9d335d344a504a40b8139a837273ee",
"md5": "12d9d011a5d427c3ce994276dd093e66",
"sha256": "64e9dfd717462b9eaaec69e2abcb1caf671e89c1ce0397a997bd3f73e22b95aa"
},
"downloads": -1,
"filename": "darkfield_cli-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "12d9d011a5d427c3ce994276dd093e66",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 27901,
"upload_time": "2025-08-03T06:17:55",
"upload_time_iso_8601": "2025-08-03T06:17:55.774838Z",
"url": "https://files.pythonhosted.org/packages/2d/2b/bf2f03662b169525f2c6ee7fa2033b9d335d344a504a40b8139a837273ee/darkfield_cli-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4e1937e645ce02503eeee6b36b8ad44df77b595334c9abef75976d4d53d50cc4",
"md5": "17a41de7aeb9d0d052d7bf8c82fb17e5",
"sha256": "60b9c9a1b7b27976bbaa64300831970c262c0db0a64a609f53aa0179fa5a7a8f"
},
"downloads": -1,
"filename": "darkfield_cli-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "17a41de7aeb9d0d052d7bf8c82fb17e5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 24834,
"upload_time": "2025-08-03T06:17:56",
"upload_time_iso_8601": "2025-08-03T06:17:56.894553Z",
"url": "https://files.pythonhosted.org/packages/4e/19/37e645ce02503eeee6b36b8ad44df77b595334c9abef75976d4d53d50cc4/darkfield_cli-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-03 06:17:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "darkfield-ai",
"github_project": "darkfield-cli",
"github_not_found": true,
"lcname": "darkfield-cli"
}