Metadata-Version: 2.4
Name: talocode-doculane
Version: 0.1.0
Summary: Office document CLI for agents — read, write, and edit Word, Excel, PowerPoint without Office installed
Project-URL: Homepage, https://github.com/talocode/doculane
Project-URL: Documentation, https://docs.talocode.site
Project-URL: Repository, https://github.com/talocode/doculane
Project-URL: Issues, https://github.com/talocode/doculane/issues
Author: Talocode
License-Expression: MIT
Keywords: agents,cli,documents,excel,mcp,office,powerpoint,sdk,talocode,word
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
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: Topic :: Office/Business
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Provides-Extra: all
Requires-Dist: openpyxl>=3.1.0; extra == 'all'
Requires-Dist: python-docx>=1.0.0; extra == 'all'
Requires-Dist: python-pptx>=0.6.21; extra == 'all'
Provides-Extra: dev
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Provides-Extra: excel
Requires-Dist: openpyxl>=3.1.0; extra == 'excel'
Provides-Extra: powerpoint
Requires-Dist: python-pptx>=0.6.21; extra == 'powerpoint'
Provides-Extra: word
Requires-Dist: python-docx>=1.0.0; extra == 'word'
Description-Content-Type: text/markdown

# DocuLane

**Office document CLI for agents — read, write, and edit Word, Excel, PowerPoint without Office installed.**

[![PyPI version](https://badge.fury.io/py/talocode-doculane.svg)](https://pypi.org/project/talocode-doculane/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Open-source CLI and SDK that give coding agents direct access to Office documents — Word (.docx), Excel (.xlsx), and PowerPoint (.pptx). No Microsoft Office installation required.

## Why it exists

Agents need to process business documents — reports, spreadsheets, presentations. DocuLane makes this possible without Office licenses or installations:

- **CLI-first** — command-line interface for agents
- **Local-first** — run the open tool with your own files
- **Hosted path** — sell/meter usage under `/v1/doculane/*`
- **No dependencies** — works without Microsoft Office

Part of [Talocode](https://talocode.site): open tools people trust, hosted power behind them.

## Install

```bash
pip install talocode-doculane
```

With optional dependencies:

```bash
pip install talocode-doculane[all]  # Excel + Word + PowerPoint
pip install talocode-doculane[excel]  # Excel only
pip install talocode-doculane[word]  # Word only
pip install talocode-doculane[powerpoint]  # PowerPoint only
```

## Quickstart

```python
from doculane import DocuLaneClient

client = DocuLaneClient()

# Read an Excel file
data = client.read("report.xlsx")
print(data["sheets"][0]["data"])

# Write a Word document
client.write("output.docx", {
    "paragraphs": ["Hello World", "Second paragraph"]
})

# Get capabilities
print(client.capabilities())
```

## Supported formats

| Format | Extension | Read | Write | Notes |
|--------|-----------|------|-------|-------|
| Word | .docx, .doc | ✅ | ✅ | Text extraction and creation |
| Excel | .xlsx, .xls | ✅ | ✅ | Multi-sheet support |
| PowerPoint | .pptx, .ppt | ✅ | ✅ | Slide management |

## API surface

### Local engine

| Function | Description |
|----------|-------------|
| `read_excel(path)` | Read Excel workbook |
| `write_excel(path, data)` | Write Excel workbook |
| `read_word(path)` | Read Word document |
| `write_word(path, data)` | Write Word document |
| `read_powerpoint(path)` | Read PowerPoint |
| `write_powerpoint(path, data)` | Write PowerPoint |

### Hosted routes (Talocode Cloud)

| Method | Path | Credits |
|--------|------|---------|
| GET | `/v1/doculane/health` | 0 |
| GET | `/v1/doculane/pricing` | 0 |
| GET | `/v1/doculane/capabilities` | 0 |
| POST | `/v1/doculane/read` | 5 |
| POST | `/v1/doculane/write` | 5 |

Auth:

```
Authorization: Bearer $TALOCODE_API_KEY
```

## CLI

```bash
doculane read <file>
doculane write <file> <json-data>
doculane info <file>
doculane health
doculane capabilities
doculane pricing
```

## Develop

```bash
git clone https://github.com/talocode/doculane
cd doculane/python
pip install -e ".[dev]"
pytest
```

## Related packages

| Package | Install |
|---------|---------|
| DocuLane (this package) | `pip install talocode-doculane` |
| ContextLane | `pip install contextlane` |
| DevTool | `pip install talocode-devtool` |

## Talocode ecosystem

| Product | Repo | Notes |
|---------|------|-------|
| [DocuLane](https://github.com/talocode/doculane) | `talocode/doculane` | **(this package)** Office document CLI |
| [XSearchLane](https://github.com/talocode/xsearchlane) | `talocode/xsearchlane` | Realtime X search MCP/API |
| [XProLane](https://github.com/talocode/xprolane) | `talocode/xprolane` | X Pro setup & signal dashboard |
| [SearchLane](https://github.com/talocode/searchlane) | `talocode/searchlane` | Agent web search & research |
| [Tera](https://github.com/talocode/tera) | `talocode/tera` | Hosted writing/coding capability API |
| [Codra](https://github.com/talocode/codra) | `talocode/codra` | Coding agent runtime |
| [StackLane](https://github.com/talocode/stacklane) | `talocode/stacklane` | Cloud control plane, keys, wallet |
| [GateLane](https://github.com/talocode/gatelane) | `talocode/gatelane` | Policy / gate tooling |
| [ContextLane](https://github.com/talocode/contextlane) | `talocode/contextlane` | Context infrastructure |
| [ScreenLane](https://github.com/talocode/screenlane) | `talocode/screenlane` | Screen/agent UI tooling |
| [MemoryLane](https://github.com/talocode/memorylane) | `talocode/memorylane` | Memory for agents |
| [Tradia](https://github.com/talocode/tradia) | `talocode/tradia` | Trading tooling |
| [DevTool](https://github.com/talocode/devtool) | `talocode/devtool` | Developer utilities |
| [Agent Browser](https://github.com/talocode/agent-browser) | `talocode/agent-browser` | Browser automation API |
| [InvoiceLane](https://github.com/talocode/invoicelane) | `talocode/invoicelane` | Invoicing |
| [GeoLane](https://github.com/talocode/geolane) | `talocode/geolane` | Geo visibility |
| [ClipLoop](https://github.com/talocode/cliploop) | `talocode/cliploop` | Short-form video loop |

More: [github.com/talocode](https://github.com/talocode) · [talocode.site](https://talocode.site) · [docs.talocode.site](https://docs.talocode.site)

## Links

- GitHub: https://github.com/talocode/doculane
- PyPI: https://pypi.org/project/talocode-doculane
- Docs: https://docs.talocode.site
- API base: `https://api.talocode.site`

## License

MIT © Talocode
