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.2.tar.gz (6.6 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.2-py3-none-any.whl (5.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: novyx_crewai-1.1.2.tar.gz
  • Upload date:
  • Size: 6.6 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.2.tar.gz
Algorithm Hash digest
SHA256 e78741d27620547869dfb54c8c6bef14c608ee1d4925801f69e78cc90098ea1f
MD5 ca102ce885a7c39fd47b71f7f5810954
BLAKE2b-256 41cb5e7cd4b048e945ff0db53b6417b4aa20d24390678af2e27d2839ba121f4e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: novyx_crewai-1.1.2-py3-none-any.whl
  • Upload date:
  • Size: 5.4 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 aeb9d65dbaef9d07eddda3ab0cc58b65df66ef965624a1d29b2946158492aa22
MD5 d6fa9c1cee99da4c030f325749b4c920
BLAKE2b-256 e42275a7d9ce3d256edc638975ee3936f87b8d1ecbe5c365328119c1db60ca12

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