Metadata-Version: 2.4
Name: nightshift-sdk
Version: 0.4.1
Summary: Nightshift — autonomous agent orchestrator with Firecracker VMs
Project-URL: Homepage, https://nightshift.sh
Project-URL: Documentation, https://docs.nightshift.sh
Project-URL: Repository, https://github.com/tensor-ninja/nightshift
Project-URL: Issues, https://github.com/tensor-ninja/nightshift/issues
Author: Nightshift Contributors
License: Apache-2.0
License-File: LICENSE
Keywords: agents,ai,claude,firecracker,microvm,orchestrator
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: System :: Distributed Computing
Requires-Python: >=3.12
Requires-Dist: aiosqlite>=0.22.1
Requires-Dist: anthropic
Requires-Dist: claude-agent-sdk
Requires-Dist: click
Requires-Dist: fastapi
Requires-Dist: httpx
Requires-Dist: httpx-sse
Requires-Dist: sse-starlette
Requires-Dist: tomli-w
Requires-Dist: uvicorn
Description-Content-Type: text/markdown

<p align="center">
  <img src="docs/logo/kokapo.gif" alt="Kokapo" width="120" />
</p>

<p align="center">
  <img src="docs/logo/nightshift-text.png" alt="Nightshift" width="400" />
</p>

<p align="center">
  Platform for securly running Agents with incredible devX
</p>

<p align="center">
  <a href="https://pypi.org/project/nightshift-sdk/"><img src="https://img.shields.io/pypi/v/nightshift-sdk" alt="PyPI" /></a>
</p>

<p align="center">
  <a href="https://nightshift.sh">Website</a> &middot;
  <a href="https://docs.nightshift.sh">Docs</a> &middot;
  <a href="https://join.slack.com/t/nightshiftoss/shared_invite/zt-3p5dshiiq-hjB8558QvURDgqqCI7e8RQ">Slack</a>
</p>

---

# Nightshift

Nightshift runs AI agents in isolated [Firecracker](https://firecracker-microvm.github.io/) microVMs on bare-metal infrastructure. 
Each agent gets its own microVM with a dedicated filesystem, network, and resource limits; so agents can execute code, edit files, and make network calls without affecting the host or each other.

## Installation

```bash
uv add nightshift-sdk
```

or

```bash
pip install nightshift-sdk
```

## Quick Start

Define an agent with `NightshiftApp` and `AgentConfig`:

```python
from nightshift import NightshiftApp, AgentConfig
from claude_agent_sdk import query, ClaudeAgentOptions

app = NightshiftApp()

@app.agent(
    AgentConfig(
        workspace="./my-project",
        vcpu_count=2,
        mem_size_mib=2048,
        timeout_seconds=1800,
    )
)
async def code_reviewer(prompt: str):
    async for message in query(
        prompt=prompt,
        options=ClaudeAgentOptions(
            cwd="/workspace",
            allowed_tools=["Read", "Glob", "Grep"],
            model="claude-sonnet-4-6",
        ),
    ):
        yield message
```

Deploy to a platform running Nightshift:

```bash
nightshift login --url https://api.nightshift.sh
nightshift deploy agent.py
nightshift run code_reviewer --prompt "Review the auth module for security issues" --follow
```

## Documentation

Full documentation at [docs.nightshift.sh](https://docs.nightshift.sh).

## License

Apache 2.0 — see [LICENSE](LICENSE).
