crewlayer 0.1.0__py3-none-any.whl

crewlayer-0.1.0.dist-info/METADATA

@@ -0,0 +1,232 @@
+Metadata-Version: 2.4
+Name: crewlayer
+Version: 0.1.0
+Summary: Open source memory & context backend for AI agents
+Project-URL: Homepage, https://github.com/GerardSole/CrewLayer
+Project-URL: Repository, https://github.com/GerardSole/CrewLayer
+Project-URL: Documentation, https://github.com/GerardSole/CrewLayer/blob/main/sdk/README.md
+Project-URL: Bug Tracker, https://github.com/GerardSole/CrewLayer/issues
+Author-email: Gerard Solé <gesoca2003@gmail.com>
+License: MIT
+Keywords: agents,ai,autogen,context,crewai,crewlayer,langchain,llamaindex,llm,memory
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: httpx<1.0,>=0.27.0
+Provides-Extra: all-integrations
+Requires-Dist: crewai>=0.28.0; extra == 'all-integrations'
+Requires-Dist: langchain-core<1.0,>=0.2.0; extra == 'all-integrations'
+Requires-Dist: llama-index-core>=0.10.0; extra == 'all-integrations'
+Requires-Dist: pyautogen>=0.2.0; extra == 'all-integrations'
+Provides-Extra: autogen
+Requires-Dist: pyautogen>=0.2.0; extra == 'autogen'
+Provides-Extra: build
+Requires-Dist: build>=1.2; extra == 'build'
+Requires-Dist: twine>=6.0; extra == 'build'
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.28.0; extra == 'crewai'
+Provides-Extra: dev
+Requires-Dist: httpx<1.0,>=0.27.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: langchain
+Requires-Dist: langchain-core<1.0,>=0.2.0; extra == 'langchain'
+Provides-Extra: llamaindex
+Requires-Dist: llama-index-core>=0.10.0; extra == 'llamaindex'
+Description-Content-Type: text/markdown
+
+# CrewLayer Python SDK
+
+Open source memory & context backend for AI agents.
+Persistent memory, action logging, and shared blackboard — all in one REST API.
+
+[![PyPI](https://img.shields.io/pypi/v/crewlayer)](https://pypi.org/project/crewlayer/)
+[![Python](https://img.shields.io/pypi/pyversions/crewlayer)](https://pypi.org/project/crewlayer/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/GerardSole/CrewLayer/blob/main/LICENSE)
+
+**Source & docs:** [github.com/GerardSole/CrewLayer](https://github.com/GerardSole/CrewLayer)
+
+---
+
+## Install
+
+```bash
+pip install crewlayer
+```
+
+Requires Python 3.12+. Runtime dependency: `httpx` only.
+
+---
+
+## Quick start
+
+```python
+from crewlayer import CrewLayerClient
+
+client = CrewLayerClient(api_key="crwl_...", base_url="http://localhost:8000")
+
+# Persist a message to short-term memory
+client.memory.append(agent_id="agent-uuid", role="user", content="I prefer dark mode")
+
+# Semantic recall from long-term memory
+results = client.memory.recall(agent_id="agent-uuid", query="UI preferences", limit=5)
+for item in results.results:
+    print(f"[{item.similarity:.2f}] {item.content}")
+
+# Log an action (full audit trail)
+client.actions.log(agent_id="agent-uuid", tool_name="web_search",
+                   input_params={"q": "crewlayer"}, status="success", duration_ms=120)
+
+# Shared blackboard between agents
+client.context.write(namespace="project-42", key="phase", value={"stage": "planning"})
+entry = client.context.read("project-42", "phase")
+print(entry.value)   # {"stage": "planning"}
+
+client.close()
+```
+
+---
+
+## Async client
+
+```python
+import asyncio
+from crewlayer import CrewLayerAsyncClient
+
+async def main():
+    async with CrewLayerAsyncClient(api_key="crwl_...") as client:
+        await client.memory.append(agent_id="agent-uuid", role="user", content="Hello")
+        result = await client.memory.recall(agent_id="agent-uuid", query="greeting")
+        print(result.results)
+
+asyncio.run(main())
+```
+
+---
+
+## Integrations
+
+Optional extras bring first-class support for popular AI frameworks.
+Each integration falls back gracefully when the framework is not installed.
+
+| Extra | Install | What you get |
+|---|---|---|
+| `langchain` | `pip install crewlayer[langchain]` | `AgentLayerMemory`, `AgentLayerVectorStore`, `AgentLayerCallbackHandler` |
+| `crewai` | `pip install crewlayer[crewai]` | `AgentLayerMemoryProvider`, `AgentLayerTaskLogger` |
+| `llamaindex` | `pip install crewlayer[llamaindex]` | `CrewLayerMemoryBuffer`, `CrewLayerVectorIndex`, `CrewLayerQueryEngine`, `CrewLayerCallbackManager` |
+| `autogen` | `pip install crewlayer[autogen]` | `CrewLayerConversableAgent`, `CrewLayerGroupChatManager`, `CrewLayerAgentMemory`, `sync_agent_status` |
+| `all-integrations` | `pip install crewlayer[all-integrations]` | All of the above |
+
+### LangChain
+
+```python
+from crewlayer import CrewLayerClient
+from crewlayer.integrations.langchain import AgentLayerMemory
+from langchain.chains import ConversationChain
+from langchain_openai import ChatOpenAI
+
+client = CrewLayerClient(api_key="crwl_...")
+memory = AgentLayerMemory(client=client, agent_id="agent-uuid", session_id="user-123")
+chain = ConversationChain(llm=ChatOpenAI(), memory=memory)
+chain.predict(input="What's my name?")
+```
+
+### CrewAI
+
+```python
+from crewlayer.integrations.crewai import AgentLayerMemoryProvider, AgentLayerTaskLogger
+from crewai.memory import LongTermMemory
+from crewai import Task
+
+storage = AgentLayerMemoryProvider(client=client, agent_id="agent-uuid")
+ltm = LongTermMemory(storage=storage)
+
+logger = AgentLayerTaskLogger(client=client, agent_id="agent-uuid")
+task = Task(description="Summarize feedback", expected_output="...", agent=agent, callback=logger)
+```
+
+### LlamaIndex
+
+```python
+from crewlayer.integrations.llamaindex import CrewLayerVectorIndex
+from llama_index.core.schema import Document
+
+index = CrewLayerVectorIndex(client=client, agent_id="agent-uuid", similarity_top_k=4)
+index.insert(Document(text="User prefers dark mode"))
+engine = index.as_query_engine()
+response = engine.query("UI preferences")
+print(response.response)
+```
+
+### AutoGen (multi-agent blackboard)
+
+The killer feature: `CrewLayerGroupChatManager` writes every turn to a shared blackboard.
+Any agent — or external observer — can read live group state without being in the chat.
+
+```python
+from crewlayer.integrations.autogen import (
+    CrewLayerConversableAgent, CrewLayerGroupChatManager, CrewLayerAgentMemory,
+)
+import autogen
+
+client = CrewLayerClient(api_key="crwl_...")
+researcher = CrewLayerConversableAgent(name="researcher", client=client, agent_id="uuid-r",
+                                       llm_config={"config_list": [...]})
+writer = CrewLayerConversableAgent(name="writer", client=client, agent_id="uuid-w",
+                                   llm_config={"config_list": [...]})
+
+groupchat = autogen.GroupChat(agents=[researcher, writer], messages=[], max_round=10)
+manager = CrewLayerGroupChatManager(client=client, group_id="project-alpha", groupchat=groupchat)
+CrewLayerAgentMemory(client=client, agent_id="uuid-r").apply(researcher)
+
+researcher.initiate_chat(manager, message="Let's plan the release.")
+
+# From anywhere — see who spoke last
+latest = client.context.read("project-alpha", "latest_turn")
+print(latest.value)  # {"agent": "writer", "content": "...", "turn": 3}
+```
+
+---
+
+## Error handling
+
+```python
+from crewlayer import CrewLayerError, AuthError, NotFoundError, ConflictError, RateLimitError
+
+try:
+    client.memory.recall(agent_id="bad-id", query="test")
+except AuthError:
+    print("Invalid API key")
+except NotFoundError:
+    print("Agent not found")
+except ConflictError as e:
+    print(f"Version conflict: {e}")
+except RateLimitError:
+    print("Rate limited")
+except CrewLayerError as e:
+    print(f"HTTP {e.status_code}: {e}")
+```
+
+All exceptions expose `.status_code` (int | None) and `.response` (dict | None).
+
+---
+
+## Self-hosting
+
+```bash
+git clone https://github.com/GerardSole/CrewLayer
+cd CrewLayer
+docker compose up -d       # starts PostgreSQL + Redis
+alembic upgrade head
+uvicorn main:app --reload  # API at http://localhost:8000
+```
+
+Full documentation: [github.com/GerardSole/CrewLayer](https://github.com/GerardSole/CrewLayer)

crewlayer-0.1.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+crewlayer/__init__.py,sha256=G0j2q8dxdGYXLYvUS6aBiSmMjbtXZkFXcu1oNgOMpM4,1077
+crewlayer/_actions.py,sha256=fIUR6LnDjtenvPXzfMaSLz0tpgDlv4VUSvBXPyCGdSA,5239
+crewlayer/_client.py,sha256=7CnW6SLQmMmHrAAFkbjwTYdLrBO_aMeODTOr6DY03EQ,2609
+crewlayer/_context.py,sha256=JbyBN0Vd6ozJQmVPxq5cPMHjj2CfBvQgynJ8iBsSZqY,3871
+crewlayer/_exceptions.py,sha256=mJyr2NrVazKhYLPjdQRjHX-_zzmTjqsKR_ixQF59INc,1896
+crewlayer/_http.py,sha256=bfp-f7ZzR27X_u78c0H_vQf7bYgeppZPsY3OaSsId7w,3284
+crewlayer/_memory.py,sha256=oPByTsTE1ojZLzbXDNHsiPhig1heKskirHxNrybFT9E,5824
+crewlayer/_types.py,sha256=Kpwh4TOA4PITT8R3K5hENUesZunguogT-mtp9-hX6vQ,6525
+crewlayer/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+crewlayer/integrations/__init__.py,sha256=4IRdw0kQ--epapo-valWKlQKcT4pbPuJlWz9rchnlLM,202
+crewlayer/integrations/autogen.py,sha256=_A9jEUmB7U6mw9wOpkrBuJkWuTq7r_2in7mDcvuTjt8,18273
+crewlayer/integrations/crewai.py,sha256=Fm7KCLbeNaeJtlVbCbtxldmZQ4678DyDGqNMsX6BqYE,7238
+crewlayer/integrations/langchain.py,sha256=wQ8PLUTYLqG2P0f9j6Ym4HCMlvlCg7Hal2XOu_VHu9I,14149
+crewlayer/integrations/llamaindex.py,sha256=vXYkXH9AwEf2Hmen6Oo2IZrCWK5l3W4hP1izwiS4k04,18289
+crewlayer-0.1.0.dist-info/METADATA,sha256=eNp6O2Jo4NW7q29-53qg-aIih1esm2h-6kVgXvBHiqA,8323
+crewlayer-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+crewlayer-0.1.0.dist-info/RECORD,,

crewlayer-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any