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.0.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.0-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: exoclaw_tools_workspace-0.4.0.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":null}

File hashes

Hashes for exoclaw_tools_workspace-0.4.0.tar.gz
Algorithm Hash digest
SHA256 f17b21eec96b5b23c76de77ed6497f9310e3ebe4fde1cafc2ccad2ce7eca20ce
MD5 edcf4b4d4b67f26bdcba6a9476956791
BLAKE2b-256 cd20dc53ef8381d9d4d5a5ad4798234b843261ee17c6e04108344a4b46dec37d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: exoclaw_tools_workspace-0.4.0-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":null}

File hashes

Hashes for exoclaw_tools_workspace-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8cfb784b5ff31306c267d3d9b9630a94621c809955aa66ca8740bb7532374c98
MD5 1a5346ba8d2562f3ce65b9ae15d65fec
BLAKE2b-256 9c195102b360d15492cfecd39458b4a608c1d2a2a6a0e54d4293a8e9663c263f

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