Persistent memory + rollback + audit trail for CrewAI agents using Novyx Core
Project description
novyx-crewai
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. Returnslist[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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e78741d27620547869dfb54c8c6bef14c608ee1d4925801f69e78cc90098ea1f
|
|
| MD5 |
ca102ce885a7c39fd47b71f7f5810954
|
|
| BLAKE2b-256 |
41cb5e7cd4b048e945ff0db53b6417b4aa20d24390678af2e27d2839ba121f4e
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
aeb9d65dbaef9d07eddda3ab0cc58b65df66ef965624a1d29b2946158492aa22
|
|
| MD5 |
d6fa9c1cee99da4c030f325749b4c920
|
|
| BLAKE2b-256 |
e42275a7d9ce3d256edc638975ee3936f87b8d1ecbe5c365328119c1db60ca12
|