Skip to main content

File, shell, and web tools for exoclaw

Project description

exoclaw-tools-workspace

File system, shell, and web tools implementing the exoclaw ToolBase protocol — read/write/edit files, list directories, execute shell commands, search the web, and fetch URLs.

Install

pip install exoclaw-tools-workspace

Usage

from pathlib import Path
from exoclaw_tools_workspace.filesystem import ReadFileTool, WriteFileTool, EditFileTool, ListDirTool
from exoclaw_tools_workspace.shell import ExecTool
from exoclaw_tools_workspace.web import WebSearchTool, WebFetchTool

workspace = Path("~/.nanobot/workspace").expanduser()

tools = [
    ReadFileTool(workspace=workspace),
    WriteFileTool(workspace=workspace),
    EditFileTool(workspace=workspace),
    ListDirTool(workspace=workspace),
    ExecTool(timeout=30, working_dir=str(workspace)),
    WebSearchTool(api_key="..."),   # Brave Search API key, or set BRAVE_API_KEY
    WebFetchTool(),
]

All tools accept an optional allowed_dir to restrict file operations to within a directory. ExecTool ships with a built-in deny-list of destructive shell patterns.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

exoclaw_tools_workspace-0.4.1.tar.gz (10.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

exoclaw_tools_workspace-0.4.1-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

Details for the file exoclaw_tools_workspace-0.4.1.tar.gz.

File metadata

  • Download URL: exoclaw_tools_workspace-0.4.1.tar.gz
  • Upload date:
  • Size: 10.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for exoclaw_tools_workspace-0.4.1.tar.gz
Algorithm Hash digest
SHA256 fe29687311283ba3d1af001d53db230af106a9759dd4e60ae4c123c3a4b2d1bd
MD5 d862a1db6935f3424049872ae5768c84
BLAKE2b-256 ac3c7a9e36934bb48cab70609081f18f5dc162c76b0f4e8220c74dba5d336e3b

See more details on using hashes here.

File details

Details for the file exoclaw_tools_workspace-0.4.1-py3-none-any.whl.

File metadata

  • Download URL: exoclaw_tools_workspace-0.4.1-py3-none-any.whl
  • Upload date:
  • Size: 9.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for exoclaw_tools_workspace-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d3e3d92bfb7d50b0b2b253848d9bbd94ab38f24ed49f9fd156bdd9506e9f9fc5
MD5 f17eeea25aac102e1b3ccf15b91579bb
BLAKE2b-256 0b04a961e52d926b33e526e16baa0c29f73a69da664c218aa8368bcdc14b97bf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page