Skip to main content

Persistent memory + rollback + audit trail for CrewAI agents using Novyx Core

Project description

novyx-crewai

PyPI version Python versions License

Persistent memory storage for CrewAI agents using Novyx Core.

Drop-in storage backend that gives your CrewAI agents persistent, semantic memory powered by Novyx RAM.

Installation

pip install novyx-crewai

Quick Start

1. Get an API Key

Sign up at novyxlabs.com to get your API key.

2. Use with CrewAI

import os
from crewai import Agent, Crew, Task
from novyx_crewai import NovyxStorage

# Create persistent storage backed by Novyx
storage = NovyxStorage(
    api_key=os.getenv("NOVYX_API_KEY"),
    memory_type="short_term",
)

# Create an agent
researcher = Agent(
    role="Researcher",
    goal="Find and summarize information",
    backstory="You are a research assistant.",
    verbose=True,
)

task = Task(
    description="Research the latest trends in AI agents.",
    expected_output="A short summary of trends.",
    agent=researcher,
)

# Build a crew with Novyx-backed memory
crew = Crew(
    agents=[researcher],
    tasks=[task],
    memory=True,
    short_term_memory=storage,
)

result = crew.kickoff()
print(result)

3. Standalone Usage

You can also use NovyxStorage directly without CrewAI:

from novyx_crewai import NovyxStorage

storage = NovyxStorage(api_key="nram_xxx")

# Save a memory
storage.save("The user prefers concise answers.", agent="researcher")

# Search memories
results = storage.search("user preferences", limit=5)
for r in results:
    print(f"[{r['score']:.2f}] {r['context']}")

# Clear all memories for this storage type
storage.reset()

API

NovyxStorage(api_key, memory_type="short_term", api_url=None)

Parameter Type Default Description
api_key str required Your Novyx API key
memory_type str "short_term" Memory type tag (e.g. short_term, long_term, entity)
api_url str None Custom API URL (defaults to Novyx production)

Methods

  • save(value, metadata=None, agent=None) -- Store a memory with optional metadata and agent tag.
  • search(query, limit=10, score_threshold=0.5) -- Search memories. Returns list[dict] with "context" and "score" keys.
  • reset() -- Delete all memories tagged with this storage's memory type.

License

MIT License - see LICENSE for details.

Links

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

novyx_crewai-1.1.1.tar.gz (6.7 kB view details)

Uploaded Source

Built Distribution

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

novyx_crewai-1.1.1-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file novyx_crewai-1.1.1.tar.gz.

File metadata

  • Download URL: novyx_crewai-1.1.1.tar.gz
  • Upload date:
  • Size: 6.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for novyx_crewai-1.1.1.tar.gz
Algorithm Hash digest
SHA256 c57055251308ce9bfc3aad11e6f052012a26d0856d8409f5b77dcc913eee4f7d
MD5 946b66bd059b769498a9199ebc3a2629
BLAKE2b-256 ec1759c4cf5267cbe8097d9cc44be7b380e48c5c1fa7398979c01ec3e53fbaaa

See more details on using hashes here.

File details

Details for the file novyx_crewai-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: novyx_crewai-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for novyx_crewai-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4e67328731cc338b8496e52183fb4ff2dcfd5837adce92a382b093b7e1f81018
MD5 5d685b4366d8edbb67f472384f6aac35
BLAKE2b-256 b44f7acd68eb588192768def5f2ce1b9e915819baf9b9c25f90109bb76cbe18d

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