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.1.0.tar.gz (13.7 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.1.0-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: angel_claw-0.1.0.tar.gz
  • Upload date:
  • Size: 13.7 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.1.0.tar.gz
Algorithm Hash digest
SHA256 b07a2e047c96a0efc30a3ff79a4710c34a5bcd1b2bba66c143c59636b5d6f30c
MD5 09d2166aafa7f7a4a6550666398a18e8
BLAKE2b-256 efa7bcbd7db7e7cc9070a5982740791f8a364743eb928ebdaed08ef40fcbbe59

See more details on using hashes here.

File details

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

File metadata

  • Download URL: angel_claw-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 15.5 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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b9f9b5351969bbdeb996e43d3ebecc482db062b5e9ce6f28f40feff8f5efd118
MD5 bd25cbf4c613f4efcd18da67551f4861
BLAKE2b-256 39bb9d9892e973386c3562008bd4e4792308ccf2b7979432e73705415dec5969

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