# opencode-client
Python client for [opencode](https://github.com/sst/opencode) server API.
## Installation
```bash
pip install opencode-client
```
## Usage
```python
from opencode_client import OpencodeClient
# Create client (defaults to http://localhost:36000)
client = OpencodeClient()
# Or specify custom URL
client = OpencodeClient(base_url="http://localhost:8000")
# List sessions
sessions = client.list_sessions()
# Send message to session (by ID or title)
response = client.send_message("headless-1", "hello world")
# Get session info
session = client.get_session("ses_abc123")
# Create new session
new_session = client.create_session(title="My Session")
# List messages
messages = client.list_messages("headless-1")
```
## Environment Variables
- `OPENCODE_SERVER` - Override default server URL (default: `http://localhost:36000`)
## License
MIT
Raw data
{
"_id": null,
"home_page": null,
"name": "opencode-sdk",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "opencode, ai, agent, client, sdk",
"author": "Fergus Fettes",
"author_email": "Fergus Fettes <fergusfettes@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/df/a1/a798783ce33c93a4c440200146678082de82ec142742c2ee7c03c1e63fb4/opencode_sdk-0.2.0.tar.gz",
"platform": null,
"description": "# opencode-client\n\nPython client for [opencode](https://github.com/sst/opencode) server API.\n\n## Installation\n\n```bash\npip install opencode-client\n```\n\n## Usage\n\n```python\nfrom opencode_client import OpencodeClient\n\n# Create client (defaults to http://localhost:36000)\nclient = OpencodeClient()\n\n# Or specify custom URL\nclient = OpencodeClient(base_url=\"http://localhost:8000\")\n\n# List sessions\nsessions = client.list_sessions()\n\n# Send message to session (by ID or title)\nresponse = client.send_message(\"headless-1\", \"hello world\")\n\n# Get session info\nsession = client.get_session(\"ses_abc123\")\n\n# Create new session\nnew_session = client.create_session(title=\"My Session\")\n\n# List messages\nmessages = client.list_messages(\"headless-1\")\n```\n\n## Environment Variables\n\n- `OPENCODE_SERVER` - Override default server URL (default: `http://localhost:36000`)\n\n## License\n\nMIT\n",
"bugtrack_url": null,
"license": null,
"summary": "Python client for opencode server API",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/fergusfettes/opencode-client",
"Repository": "https://github.com/fergusfettes/opencode-client"
},
"split_keywords": [
"opencode",
" ai",
" agent",
" client",
" sdk"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ee2c88f75771cde9a94972429a9fb58e5dee8729202ad6dc1bd17b9886cf28e5",
"md5": "02d45a9b48cb4f2342beee5af0db9b69",
"sha256": "d64b6c735560487c6d58f4a8c20c99a19aa9859789f32db8bece8ca07dbeeb15"
},
"downloads": -1,
"filename": "opencode_sdk-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "02d45a9b48cb4f2342beee5af0db9b69",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 4823,
"upload_time": "2025-10-22T19:31:25",
"upload_time_iso_8601": "2025-10-22T19:31:25.024904Z",
"url": "https://files.pythonhosted.org/packages/ee/2c/88f75771cde9a94972429a9fb58e5dee8729202ad6dc1bd17b9886cf28e5/opencode_sdk-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "dfa1a798783ce33c93a4c440200146678082de82ec142742c2ee7c03c1e63fb4",
"md5": "e629a6d29b02d6a91dde069f3af4b0a3",
"sha256": "f804b525f33e0d45eca7dc3734ad2f77fa186a986edcdd608654338f5facf4d8"
},
"downloads": -1,
"filename": "opencode_sdk-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "e629a6d29b02d6a91dde069f3af4b0a3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 3151,
"upload_time": "2025-10-22T19:31:26",
"upload_time_iso_8601": "2025-10-22T19:31:26.258405Z",
"url": "https://files.pythonhosted.org/packages/df/a1/a798783ce33c93a4c440200146678082de82ec142742c2ee7c03c1e63fb4/opencode_sdk-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-22 19:31:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "fergusfettes",
"github_project": "opencode-client",
"github_not_found": true,
"lcname": "opencode-sdk"
}