grkmemory 1.0.0__tar.gz

grkmemory-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Arthur Vaz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

grkmemory-1.0.0/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: grkmemory
+Version: 1.0.0
+Summary: GRKMemory (Graph Retrieve Knowledge Memory) - A semantic graph-based memory system for AI agents developed by MonkAI team
+Author-email: Arthur Vaz <contato@monkai.com.br>
+Maintainer-email: Arthur Vaz <contato@monkai.com.br>
+License: MIT
+Project-URL: Homepage, https://github.com/BeMonkAI/GRKMemory
+Project-URL: Documentation, https://github.com/BeMonkAI/GRKMemory#readme
+Project-URL: Repository, https://github.com/BeMonkAI/GRKMemory
+Project-URL: Issues, https://github.com/BeMonkAI/GRKMemory/issues
+Keywords: grkmemory,monkai,ai,agents,memory,semantic-graph,knowledge-retrieval,openai,llm,chatgpt,conversational-ai,machine-learning
+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.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai>=1.0.0
+Requires-Dist: openai-agents>=0.6.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: embeddings
+Requires-Dist: tiktoken>=0.5.0; extra == "embeddings"
+Provides-Extra: all
+Requires-Dist: grkmemory[dev,embeddings]; extra == "all"
+Dynamic: license-file
+
+# 🧠 GRKMemory - Graph Retrieve Knowledge Memory
+
+> **GRKMemory** = **G**raph **R**etrieve **K**nowledge **Memory**
+
+[![PyPI version](https://badge.fury.io/py/grkmemory.svg)](https://badge.fury.io/py/grkmemory)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**GRKMemory** é um sistema de memória semântica baseado em grafos para agentes de IA, desenvolvido pelo time **MonkAI**. Recuperação inteligente de conhecimento com economia de 95% em tokens.
+
+## 🚀 Instalação
+
+```bash
+pip install grkmemory
+```
+
+Para token counting:
+```bash
+pip install grkmemory[embeddings]
+```
+
+## 🎯 Quick Start
+
+```python
+from grkmemory import GRKMemory
+
+# Inicializar (usa OPENAI_API_KEY do ambiente)
+grk = GRKMemory()
+
+# Buscar memórias relevantes
+results = grk.search("O que discutimos sobre IA?")
+
+# Chat com contexto de memória automático
+response = grk.chat("Me conte sobre nossas discussões anteriores")
+
+# Salvar uma conversa
+grk.save_conversation([
+    {"role": "user", "content": "Vamos falar sobre Python"},
+    {"role": "assistant", "content": "Claro! O que você quer saber?"}
+])
+```
+
+## ⚙️ Configuração
+
+```python
+from grkmemory import GRKMemory, MemoryConfig
+
+config = MemoryConfig(
+    model="gpt-4o",
+    memory_file="minhas_memorias.json",
+    enable_embeddings=True,
+    background_memory_method="graph",  # 'graph', 'embedding', 'tags', 'entities'
+    background_memory_limit=5,
+    background_memory_threshold=0.3
+)
+
+grk = GRKMemory(config=config)
+```
+
+## 🔐 Autenticação por Token
+
+```python
+from grkmemory import GRKMemory, GRKAuth, AuthenticatedGRK
+
+# Criar API key
+auth = GRKAuth()
+api_key = auth.create_api_key("Minha App", permissions=["read", "write"])
+
+# Usar GRKMemory protegido
+grk = GRKMemory()
+secure = AuthenticatedGRK(grk, api_key)
+secure.chat("Olá!")
+```
+
+### CLI para Tokens
+
+```bash
+# Criar token
+grkmemory-token create --name "Meu App" --expires 30
+
+# Listar tokens
+grkmemory-token list
+
+# Revogar token
+grkmemory-token revoke tok_abc123
+```
+
+## 📊 Métodos de Busca
+
+| Método | Descrição |
+|--------|-----------|
+| `graph` | Grafo semântico (recomendado) |
+| `embedding` | Similaridade vetorial |
+| `tags` | Busca por tags |
+| `entities` | Busca por entidades |
+
+```python
+# Busca por grafo semântico
+results = grk.search("IA", method="graph")
+
+# Busca por embedding
+results = grk.search("machine learning", method="embedding")
+```
+
+## 📈 Estatísticas
+
+```python
+# Estatísticas gerais
+stats = grk.get_stats()
+print(f"Total de memórias: {stats['total_memories']}")
+
+# Estatísticas do grafo
+graph_stats = grk.get_graph_stats()
+print(f"Nós: {graph_stats['total_nodes']}")
+print(f"Arestas: {graph_stats['total_edges']}")
+
+# Top memórias
+top = grk.get_top_memories(limit=5, by="density")
+```
+
+## 📁 Estrutura do Projeto
+
+```
+GRKMemory/
+├── grkmemory/              # 📦 Pacote principal
+│   ├── core/               # Classes principais (GRKMemory, Config, Agent)
+│   ├── memory/             # Repositório de memória
+│   ├── graph/              # Grafo semântico (GRK)
+│   ├── auth/               # Autenticação por token
+│   └── utils/              # Utilitários (embeddings, text)
+├── examples/               # 💡 Exemplos de uso
+├── demos/                  # 🎮 Demos legados
+├── papers/                 # 📄 Documentação técnica
+├── pyproject.toml          # Configuração PyPI
+└── README.md
+```
+
+## 📚 Exemplos
+
+Veja a pasta `examples/` para exemplos completos:
+
+- `01_basic_usage.py` - Uso básico
+- `02_custom_config.py` - Configuração personalizada
+- `03_chatbot_with_memory.py` - Chatbot com memória
+- `04_graph_analysis.py` - Análise do grafo
+- `05_batch_processing.py` - Processamento em lote
+- `06_authentication.py` - Autenticação por token
+
+## 🔬 Performance
+
+| Métrica | Context Window | GRKMemory |
+|---------|----------------|-----------|
+| Tokens/query | ~50.000 | ~2.500 |
+| Economia | - | **95%** |
+| Precisão | Variável | **95%** |
+| Velocidade | Lenta | **10x mais rápido** |
+
+## 📄 Licença
+
+MIT License - veja [LICENSE](LICENSE)
+
+## 👨‍💻 Autor
+
+**Arthur Vaz** - [MonkAI](https://www.monkai.com.br)

grkmemory-1.0.0/README.md

@@ -0,0 +1,164 @@
+# 🧠 GRKMemory - Graph Retrieve Knowledge Memory
+
+> **GRKMemory** = **G**raph **R**etrieve **K**nowledge **Memory**
+
+[![PyPI version](https://badge.fury.io/py/grkmemory.svg)](https://badge.fury.io/py/grkmemory)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**GRKMemory** é um sistema de memória semântica baseado em grafos para agentes de IA, desenvolvido pelo time **MonkAI**. Recuperação inteligente de conhecimento com economia de 95% em tokens.
+
+## 🚀 Instalação
+
+```bash
+pip install grkmemory
+```
+
+Para token counting:
+```bash
+pip install grkmemory[embeddings]
+```
+
+## 🎯 Quick Start
+
+```python
+from grkmemory import GRKMemory
+
+# Inicializar (usa OPENAI_API_KEY do ambiente)
+grk = GRKMemory()
+
+# Buscar memórias relevantes
+results = grk.search("O que discutimos sobre IA?")
+
+# Chat com contexto de memória automático
+response = grk.chat("Me conte sobre nossas discussões anteriores")
+
+# Salvar uma conversa
+grk.save_conversation([
+    {"role": "user", "content": "Vamos falar sobre Python"},
+    {"role": "assistant", "content": "Claro! O que você quer saber?"}
+])
+```
+
+## ⚙️ Configuração
+
+```python
+from grkmemory import GRKMemory, MemoryConfig
+
+config = MemoryConfig(
+    model="gpt-4o",
+    memory_file="minhas_memorias.json",
+    enable_embeddings=True,
+    background_memory_method="graph",  # 'graph', 'embedding', 'tags', 'entities'
+    background_memory_limit=5,
+    background_memory_threshold=0.3
+)
+
+grk = GRKMemory(config=config)
+```
+
+## 🔐 Autenticação por Token
+
+```python
+from grkmemory import GRKMemory, GRKAuth, AuthenticatedGRK
+
+# Criar API key
+auth = GRKAuth()
+api_key = auth.create_api_key("Minha App", permissions=["read", "write"])
+
+# Usar GRKMemory protegido
+grk = GRKMemory()
+secure = AuthenticatedGRK(grk, api_key)
+secure.chat("Olá!")
+```
+
+### CLI para Tokens
+
+```bash
+# Criar token
+grkmemory-token create --name "Meu App" --expires 30
+
+# Listar tokens
+grkmemory-token list
+
+# Revogar token
+grkmemory-token revoke tok_abc123
+```
+
+## 📊 Métodos de Busca
+
+| Método | Descrição |
+|--------|-----------|
+| `graph` | Grafo semântico (recomendado) |
+| `embedding` | Similaridade vetorial |
+| `tags` | Busca por tags |
+| `entities` | Busca por entidades |
+
+```python
+# Busca por grafo semântico
+results = grk.search("IA", method="graph")
+
+# Busca por embedding
+results = grk.search("machine learning", method="embedding")
+```
+
+## 📈 Estatísticas
+
+```python
+# Estatísticas gerais
+stats = grk.get_stats()
+print(f"Total de memórias: {stats['total_memories']}")
+
+# Estatísticas do grafo
+graph_stats = grk.get_graph_stats()
+print(f"Nós: {graph_stats['total_nodes']}")
+print(f"Arestas: {graph_stats['total_edges']}")
+
+# Top memórias
+top = grk.get_top_memories(limit=5, by="density")
+```
+
+## 📁 Estrutura do Projeto
+
+```
+GRKMemory/
+├── grkmemory/              # 📦 Pacote principal
+│   ├── core/               # Classes principais (GRKMemory, Config, Agent)
+│   ├── memory/             # Repositório de memória
+│   ├── graph/              # Grafo semântico (GRK)
+│   ├── auth/               # Autenticação por token
+│   └── utils/              # Utilitários (embeddings, text)
+├── examples/               # 💡 Exemplos de uso
+├── demos/                  # 🎮 Demos legados
+├── papers/                 # 📄 Documentação técnica
+├── pyproject.toml          # Configuração PyPI
+└── README.md
+```
+
+## 📚 Exemplos
+
+Veja a pasta `examples/` para exemplos completos:
+
+- `01_basic_usage.py` - Uso básico
+- `02_custom_config.py` - Configuração personalizada
+- `03_chatbot_with_memory.py` - Chatbot com memória
+- `04_graph_analysis.py` - Análise do grafo
+- `05_batch_processing.py` - Processamento em lote
+- `06_authentication.py` - Autenticação por token
+
+## 🔬 Performance
+
+| Métrica | Context Window | GRKMemory |
+|---------|----------------|-----------|
+| Tokens/query | ~50.000 | ~2.500 |
+| Economia | - | **95%** |
+| Precisão | Variável | **95%** |
+| Velocidade | Lenta | **10x mais rápido** |
+
+## 📄 Licença
+
+MIT License - veja [LICENSE](LICENSE)
+
+## 👨‍💻 Autor
+
+**Arthur Vaz** - [MonkAI](https://www.monkai.com.br)

grkmemory-1.0.0/grkmemory/__init__.py

@@ -0,0 +1,83 @@
+"""
+GRKMemory - Graph Retrieve Knowledge Memory
+============================================
+
+GRKMemory = Graph Retrieve Knowledge Memory
+
+A semantic graph-based memory system for AI agents that enables
+intelligent knowledge retrieval and structured conversation analysis.
+
+Developed by MonkAI team (https://www.monkai.com.br)
+
+Example usage:
+    from grkmemory import GRKMemory, MemoryConfig
+    
+    # Initialize with default config
+    grk = GRKMemory()
+    
+    # Or with custom configuration
+    config = MemoryConfig(
+        memory_file="my_memories.json",
+        model="gpt-4o",
+        enable_embeddings=True
+    )
+    grk = GRKMemory(config=config)
+    
+    # Search memories
+    results = grk.search("What did we discuss about AI?")
+    
+    # Save a conversation
+    grk.save_conversation(messages)
+
+Authentication Example:
+    from grkmemory import GRKMemory, GRKAuth, AuthenticatedGRK
+    
+    # Create an API key
+    auth = GRKAuth()
+    api_key = auth.create_api_key("My App", permissions=["read", "write"])
+    print(f"Your API key: {api_key}")
+    
+    # Use authenticated GRKMemory
+    grk = GRKMemory()
+    secure_grk = AuthenticatedGRK(grk, api_key)
+    secure_grk.chat("Hello!")
+
+Author: Arthur Vaz
+License: MIT
+"""
+
+__version__ = "1.0.0"
+__author__ = "Arthur Vaz"
+
+from .core.grkmemory import GRKMemory
+from .core.config import MemoryConfig
+from .memory.repository import MemoryRepository
+from .graph.semantic_graph import SemanticGraph
+from .core.agent import KnowledgeAgent
+from .auth.token_manager import TokenManager, Token
+from .auth.auth import GRKAuth, AuthenticatedGRK, require_auth
+
+# Aliases for backwards compatibility
+MonkAI = GRKMemory
+MonkAIAuth = GRKAuth
+AuthenticatedMonkAI = AuthenticatedGRK
+
+__all__ = [
+    # Core
+    "GRKMemory",
+    "MonkAI",  # alias
+    "MemoryConfig", 
+    "MemoryRepository",
+    "SemanticGraph",
+    "KnowledgeAgent",
+    # Auth
+    "TokenManager",
+    "Token",
+    "GRKAuth",
+    "MonkAIAuth",  # alias
+    "AuthenticatedGRK",
+    "AuthenticatedMonkAI",  # alias
+    "require_auth",
+    # Meta
+    "__version__",
+]

grkmemory-1.0.0/grkmemory/auth/__init__.py

@@ -0,0 +1,14 @@
+"""
+Authentication module for GRKMemory.
+
+Provides token-based authentication for API access.
+"""
+
+from .token_manager import TokenManager, Token
+from .auth import GRKAuth, AuthenticatedGRK, require_auth
+
+# Alias for backwards compatibility
+MonkAIAuth = GRKAuth
+AuthenticatedMonkAI = AuthenticatedGRK
+
+__all__ = ["TokenManager", "Token", "GRKAuth", "MonkAIAuth", "AuthenticatedGRK", "AuthenticatedMonkAI", "require_auth"]