Skip to main content

Angel Claw personal AI agent framework

Project description

Angel Claw

A personal AI agent framework based on OpenClaw, using angel-recall for memory and litellm for LLM interactions.

Features

  • FastAPI Gateway: HTTP interface for interacting with the agent.
  • Agent-Native Memory: Powered by angel-recall, providing long-term, evolvable memory for each session.
  • Multi-Model Support: Uses litellm to connect to various providers (OpenAI, Anthropic, Ollama, etc.).
  • Lane-Based Isolation: Each session has its own memory vault.

Setup

  1. Install dependencies:

    pip install angel-claw
    
  2. Configure environment: Copy .env.example to .env and fill in your API keys.

    cp .env.example .env
    
  3. Run the gateway:

    angel-claw
    

Usage

For detailed instructions on how to use Angel Claw and its skills system, see the Documentation.

Basic Chat

Send a POST request to /chat:

curl -X POST http://localhost:8000/chat \
     -H "Content-Type: application/json" \
     -d '{"session_id": "user-123", "message": "Hi, I am Alex. Remember that I like Python.", "user_id": "alex"}'

Testing

pytest

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

angel_claw-0.2.0.tar.gz (15.0 kB view details)

Uploaded Source

Built Distribution

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

angel_claw-0.2.0-py3-none-any.whl (17.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: angel_claw-0.2.0.tar.gz
  • Upload date:
  • Size: 15.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Linux Mint","version":"22.1","id":"xia","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for angel_claw-0.2.0.tar.gz
Algorithm Hash digest
SHA256 35f2a21d21625302316838d98196b8bd7f8ac5d33bd8e0ae5a9a4b0bfc6b86f8
MD5 0608b0c2dbfc3f9a07a1b62f6a56ed24
BLAKE2b-256 de0d7cdcae27a4e05e0c594d16d148403c4cd421b06b932cc9cd5f21fe6bb2d8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: angel_claw-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 17.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Linux Mint","version":"22.1","id":"xia","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for angel_claw-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 91c6a2b571d1083b7882be5bbca317d2deb2cecee240020a8bcda7284cd732d1
MD5 1d6d0423f8be772f2a255fc9b78473d3
BLAKE2b-256 c7635e14d32f3c119cb4324753567dc873c39a43f7ec3e4d8983ac1ab1086d55

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