Metadata-Version: 2.4
Name: synapserun
Version: 0.3.0
Summary: Synapse Cell SDK — E2B-compatible sandboxed code execution, 200x faster, with streaming and filesystem support
Author-email: Freshfield AI <hello@synapserun.dev>
License-Expression: MIT
Project-URL: Homepage, https://synapserun.dev
Project-URL: Documentation, https://synapserun.dev/docs
Project-URL: Repository, https://github.com/Freshfield-AI/synapse
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: System :: Emulators
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# synapserun

Synapse Cell SDK -- E2B-compatible sandboxed code execution, 200x faster.

[![PyPI](https://img.shields.io/pypi/v/synapserun)](https://pypi.org/project/synapserun/)
[![npm](https://img.shields.io/npm/v/@runsynapse/sdk)](https://www.npmjs.com/package/@runsynapse/sdk)
[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

## Install

```bash
pip install synapserun
```

```bash
npm install @runsynapse/sdk
```

Zero dependencies -- pure Python stdlib / minimal TS.

## Quick Start

```python
from synapse.cell import Cell

cell = Cell(api_key="cell_sk_...")
result = cell.run("print(2 + 2)")
info = cell.get_info()
print(result.stdout)  # "4"
cell.kill()
```

## E2B Migration (one-line change)

```python
# Before (E2B)
from e2b_code_interpreter import Sandbox

# After (Synapse -- same API, 200x faster)
from synapse.e2b_compat import Sandbox

sandbox = Sandbox()
execution = sandbox.run_code("print('hello')")
print(execution.text)  # "hello"
sandbox.kill()
```

## Features (0.3.0)

- **Sandbox lifecycle**: create, connect, list, get_info, kill
- **Filesystem**: read, write, list, exists, get_info, remove, make_dir, rename
- **Streaming**: real-time on_stdout/on_stderr callbacks via SSE
- **Background commands**: CommandHandle with is_running/wait/kill
- **Cryptographic receipts**: SHA-256 execution chain
- **E2B compatibility**: drop-in Sandbox replacement

## Full API Reference

See [cell/CLAUDE.md](../CLAUDE.md) for the complete API surface and architecture.

## License

MIT
