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.2.0.tar.gz (10.6 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.2.0-py3-none-any.whl (9.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: exoclaw_tools_workspace-0.2.0.tar.gz
  • Upload date:
  • Size: 10.6 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.2.0.tar.gz
Algorithm Hash digest
SHA256 f0b0a011dadc588b8a3a9bd0cf7c9a0e38981565845d8563a977a54baab5611c
MD5 2ebf9902b7f1f324eff1aa8d9b5c541f
BLAKE2b-256 d207c094f1cb70ce83f6e85c0287b879da6ea3591e07fef2791e00bd3831dade

See more details on using hashes here.

File details

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

File metadata

  • Download URL: exoclaw_tools_workspace-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 9.5 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.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ce71870eca187fe5d843c91a7a4c84f3c82bb34fb9329e1d4f3a6b534561a377
MD5 edc5834da0f70ca38b8ebe9888f58a46
BLAKE2b-256 eaf3d1623556610f9c395abb0d080f70cc3521f85d8e6013be6ff739db5e7f84

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