rakam-systems-core 0.1.1rc7__py3-none-any.whl

rakam_systems_core-0.1.1rc7.dist-info/METADATA

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: rakam-systems-core
+Version: 0.1.1rc7
+Summary: A Package containing core logic and schema for rakam-systems
+Author-email: Mohamed Hilel <mohammedjassemhlel@gmail.com>, Peng Zheng <pengzheng990630@outlook.com>, somebodyawesome-dev <luckynoob2011830@gmail.com>
+Requires-Python: >=3.10
+Requires-Dist: boto3>=1.26.0
+Requires-Dist: pydantic
+Description-Content-Type: text/markdown
+
+# Rakam System Core
+
+The core package of Rakam Systems providing foundational interfaces, base components, and utilities.
+
+## Overview
+
+`rakam-system-core` is the foundation of the Rakam Systems framework. It provides:
+
+- **Base Component**: Abstract base class with lifecycle management
+- **Interfaces**: Standard interfaces for agents, tools, vector stores, embeddings, and loaders
+- **Configuration System**: YAML/JSON configuration loading and validation
+- **Tracking System**: Input/output tracking for debugging and evaluation
+- **Logging Utilities**: Structured logging with color support
+
+This package is required by both `rakam-system-agent` and `rakam-systems-vectorstore`.
+
+## Installation
+
+```bash
+pip install -e ./rakam-system-core
+```
+
+## Key Components
+
+### BaseComponent
+
+All components extend `BaseComponent` which provides:
+
+- Lifecycle management with `setup()` and `shutdown()` methods
+- Auto-initialization via `__call__`
+- Context manager support
+- Built-in evaluation harness
+
+```python
+from rakam_systems_core.ai_core.base import BaseComponent
+
+class MyComponent(BaseComponent):
+    def setup(self):
+        super().setup()
+        # Initialize resources
+
+    def shutdown(self):
+        # Clean up resources
+        super().shutdown()
+
+    def run(self, *args, **kwargs):
+        # Main logic
+        pass
+```
+
+### Interfaces
+
+Standard interfaces for building AI systems:
+
+- **AgentComponent**: AI agents with sync/async support
+- **ToolComponent**: Callable tools for agents
+- **LLMGateway**: LLM provider abstraction
+- **VectorStore**: Vector storage interface
+- **EmbeddingModel**: Text embedding interface
+- **Loader**: Document loading interface
+- **Chunker**: Text chunking interface
+
+```python
+from rakam_systems_core.ai_core.interfaces.agent import AgentComponent
+from rakam_systems_core.ai_core.interfaces.tool import ToolComponent
+from rakam_systems_core.ai_core.interfaces.vectorstore import VectorStore
+```
+
+### Configuration System
+
+Load and validate configurations from YAML files:
+
+```python
+from rakam_systems_core.ai_core.config_loader import ConfigurationLoader
+
+loader = ConfigurationLoader()
+config = loader.load_from_yaml("agent_config.yaml")
+agent = loader.create_agent("my_agent", config)
+```
+
+### Tracking System
+
+Track inputs and outputs for debugging:
+
+```python
+from rakam_systems_core.ai_core.tracking import TrackingMixin
+
+class MyAgent(TrackingMixin, BaseAgent):
+    pass
+
+agent.enable_tracking(output_dir="./tracking")
+# Use agent...
+agent.export_tracking_data(format='csv')
+```
+
+## Package Structure
+
+```
+rakam-system-core/
+├── src/rakam_systems_core/
+│   ├── ai_core/
+│   │   ├── base.py              # BaseComponent
+│   │   ├── interfaces/          # Standard interfaces
+│   │   ├── config_loader.py     # Configuration system
+│   │   ├── tracking.py          # I/O tracking
+│   │   └── mcp/                 # MCP server support
+│   └── ai_utils/
+│       └── logging.py           # Logging utilities
+└── pyproject.toml
+```
+
+## Usage in Other Packages
+
+### Agent Package
+
+```python
+# rakam-system-agent uses core interfaces
+from rakam_systems_core.ai_core.interfaces.agent import AgentComponent
+from rakam_system_agent import BaseAgent
+
+agent = BaseAgent(name="my_agent", model="openai:gpt-4o")
+```
+
+### Vectorstore Package
+
+```python
+# rakam-systems-vectorstore uses core interfaces
+from rakam_systems_core.ai_core.interfaces.vectorstore import VectorStore
+from rakam_systems_vectorstore import ConfigurablePgVectorStore
+
+store = ConfigurablePgVectorStore(config=config)
+```
+
+## Development
+
+This package contains only interfaces and utilities. To contribute:
+
+1. Install in editable mode: `pip install -e ./rakam-system-core`
+2. Make changes to interfaces or utilities
+3. Ensure backward compatibility with agent and vectorstore packages
+4. Update version in `pyproject.toml`
+
+## License
+
+Apache 2.0
+
+## Links
+
+- [Main Repository](https://github.com/Rakam-AI/rakam-systems)
+- [Documentation](../docs/)
+- [Agent Package](../rakam-system-agent/)
+- [Vectorstore Package](../rakam-systems-vectorstore/)

rakam_systems_core-0.1.1rc7.dist-info/RECORD

@@ -0,0 +1,34 @@
+rakam_systems_core/__init__.py,sha256=quPHjgOzz9OiycbJClJzeq909xoyjZ9D05OkqCqQ8yI,797
+rakam_systems_core/ai_core/__init__.py,sha256=vdxaDCyMlyPxo_MPZMcm4kp0WcM-IzouDaMqffwdroI,1430
+rakam_systems_core/ai_core/base.py,sha256=z73yRZ9bhQ9GQMWmuYTf-k5RTyOXl2Py9jEHAzU6KIA,5023
+rakam_systems_core/ai_core/config.py,sha256=Xavg3Y4DuGPnY4P3evnl7K39qqZL0brEO-C_8qHqvvo,374
+rakam_systems_core/ai_core/config_loader.py,sha256=rPnp9-UdIyDBR2LjkJuekRZ4DFc1sD3s2-_Ukv15gv8,20762
+rakam_systems_core/ai_core/config_schema.py,sha256=2xeJynv67GTr1_fs35nky03a461bnDptff5k82VW7eI,16521
+rakam_systems_core/ai_core/tracking.py,sha256=6aNokIdBGlWrCw47ql7emIbuO1VGeN2BlwRNiURUWnI,20632
+rakam_systems_core/ai_core/vs_core.py,sha256=9dJUzQTB7GMBE9KDgFdcTY67A7LzGvisL6uB-at5yNM,1722
+rakam_systems_core/ai_core/interfaces/__init__.py,sha256=iGnPAQOyQqRRZq3wfNKtaPwAb7Mk6UNj6wVbxt2_Z2I,853
+rakam_systems_core/ai_core/interfaces/agent.py,sha256=hrDwyaIpZaSLesiOrz8ra8GMX31tvvnNCjG2Vapw2io,3652
+rakam_systems_core/ai_core/interfaces/chat_history.py,sha256=qWvoVES_0MTPdHd_3bd5GmgVOQg-KpMSneWDW0JqFag,4052
+rakam_systems_core/ai_core/interfaces/chunker.py,sha256=E0g4eBUL83MWE_xKiIg4nBJVtK7kS82k9YwmwSGXIjY,380
+rakam_systems_core/ai_core/interfaces/embedding_model.py,sha256=EnW732q6su9vnYuR8SYfdDSbltwuD2w7TGxshSO1OLU,331
+rakam_systems_core/ai_core/interfaces/indexer.py,sha256=XNGJ-tgX7DMiDlNCU-9G6UEJmf3bndc28FplTgVFnro,373
+rakam_systems_core/ai_core/interfaces/llm_gateway.py,sha256=tFcFCsa5Y1HbXO0TcAX5SlVbNoN3urdZSVMiPlxZKn0,3913
+rakam_systems_core/ai_core/interfaces/loader.py,sha256=w5JTN0nwPZK7iaKMUh6U2COFspsCg3ETzhsLFRjf5fI,2573
+rakam_systems_core/ai_core/interfaces/reranker.py,sha256=X8Wn8qRRo9oW66hiAi7z2vNvBKXLSm6C0akdQL_xDjo,374
+rakam_systems_core/ai_core/interfaces/retriever.py,sha256=EYqrwxnI3rzd-XedWLC1qOt4n3ZGD8_jq6zv9_yH5fA,419
+rakam_systems_core/ai_core/interfaces/tool.py,sha256=K-CCZUEGoqgnVq4tu8E0MVS6gaXOSgPazb40rI-vdxQ,5465
+rakam_systems_core/ai_core/interfaces/tool_invoker.py,sha256=jh6bg9Q8_RuMejifLgx7Gez-t6d66VS_TA8A7gkXbRA,8908
+rakam_systems_core/ai_core/interfaces/tool_loader.py,sha256=-GJ6BvFOnIop_Mg9cZNbrNhjpqYTtUY8qPFOkDmSp0Y,12110
+rakam_systems_core/ai_core/interfaces/tool_registry.py,sha256=nd4PaH24tsWf0umCf6nBszgOEdizHgofzd0Zz7YRY50,9367
+rakam_systems_core/ai_core/interfaces/vectorstore.py,sha256=q8XnDNex1J882Y3WPigTC5f21c7xvNNXRnZoomQHvrs,1200
+rakam_systems_core/ai_core/mcp/README.md,sha256=LsVdvbJCVThz40cGWjLGtYdpw2PjWZf0MJa0jDqdid4,12055
+rakam_systems_core/ai_core/mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+rakam_systems_core/ai_core/mcp/mcp_server.py,sha256=aDsNv9-3bdYPGKai4aWXoqW6HrJ9cb5JDmojAPOvuIk,10599
+rakam_systems_core/ai_utils/__init__.py,sha256=sM3eT765z34-G4XHVMtc5g3ch_FaGp4PSuzf2b5lM3A,203
+rakam_systems_core/ai_utils/logging.py,sha256=wIfoTFS5fqgRrJeFaOJUQNRd8P9gKhbjfGn28HoxWxY,3256
+rakam_systems_core/ai_utils/metrics.py,sha256=uhCjV-QPBTrOmYmxNOdg1I3ZbEv8oqAMllpYkcTLHfA,246
+rakam_systems_core/ai_utils/s3.py,sha256=rlcGwoiMDpDRdwPABPpkJ0FScovfqaTXN6hpFpnbeGc,13210
+rakam_systems_core/ai_utils/tracing.py,sha256=QivJoqQpwHfd120MBqkPKlTg7rNCI4ITMr9avrNgn0w,212
+rakam_systems_core-0.1.1rc7.dist-info/METADATA,sha256=C8mydIVlmBP-5ndsRjXDNZV-vfiGkQI18ECJboxD6_M,4549
+rakam_systems_core-0.1.1rc7.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+rakam_systems_core-0.1.1rc7.dist-info/RECORD,,

rakam_systems_core-0.1.1rc7.dist-info/WHEEL

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