Engramic is an advanced system designed to enhance AI applications with sophisticated context management and memory capabilities. Unlike conventional RAG implementations, Engramic goes beyond simple retrieval and response by integrating memory and learning mechanisms, enabling applications to synthesize their data, improving it's undersanding over time.
- Context Management: Maintain and utilize contextual awareness across multiple interactions.
- Long-Term Memory: Store and recall relevant information dynamically for more natural and intelligent responses.
- Learning Capability: Adapt over time based on interactions and inputs.
We are in early stages of development and platform testing is limited. Core concepts are in place, but the system is still evolving. We encourage developers and researchers to follow our progress and contribute to shaping the future of Engramic.
There is currently no support for the following:
- There is no support for individual users.
- T 7BFD here is no HTTP(s) interface at this time.
- There are no fallbacks if API calls fail.
- Windows and MacOS is not being tested as part of our release process.
These features, along with others, will be available in the near future.
What Engramic is ready for:
- Proof of concepts focused on folder directories with 10 or so PDFs with less than 100 pages.
- Research related to long term memory.
- Developers looking to support Engramic.
The fastest way to begin working with Engramic is to download it from pip.
pip install engramic
!!!Important. Engramic must be run from within a virtual environment (e.g. venv).
During these early phases of development, we recommend working from source code. Setting up your environment is designed to be straightforward. See the "Getting Started" section in our documentation. The complete code is available in examples/mock_profile/mock_profile.py.
Run a mock version (no API key required) of Engramic.
Step 1. Include the imports & set logging:
import logging
from typing import Any
from engramic.application.message.message_service import MessageService
from engramic.application.response.response_service import ResponseService
from engramic.application.retrieve.retrieve_service import RetrieveService
from engramic.core.host import Host
from engramic.core.prompt import Prompt
from engramic.core.response import Response
from engramic.infrastructure.system import Service
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
Step 2. Create a test service and subscribe to the MAIN_PROMPT_COMPLETE message:
class TestService(Service):
def start(self):
self.subscribe(Service.Topic.MAIN_PROMPT_COMPLETE, self.on_main_prompt_complete)
return super().start()
def on_main_prompt_complete(self, message_in: dict[str, Any]) -> None:
response = Response(**message_in)
logging.info('\n\n================[Response]==============\n%s\n\n', response.response)
self.host.shutdown()
Step 3. Create the host, add the services, and submit a prompt.
if __name__ == '__main__':
host = Host(
'mock',
[
MessageService,
RetrieveService,
ResponseService,
TestService,
],
)
retrieve_service = host.get_service(RetrieveService)
retrieve_service.submit(Prompt('Tell me about the All In podcast.'))
# The host continues to run and waits for a shutdown message to exit.
host.wait_for_shutdown()
This example uses plugins that emulate API calls (i.e. mocks) to LLMs, databases, etc. by returning deterministic data. Visit the documentation for the next "Getting Started" example to use non-mock plugins.
Pure Python
- Pluggy
- Mako
- Tomli
- Cachetools
- Websockets
- Pymupdf
- PyJWT
Pure Python & C++
- Pyzmq
Plugins are managed in the engram_profiles.toml file which is generated during the first run. Engramic currently includes the plugins listed below.
Note: Plugin dependencies are downloaded on first run of the plugin and can be viewed in the plugin.toml file located in the root directory of the plugin.
Vector DB
- ChomraDB
Database
- SQLite
LLM
- Gemini (2.0)
Embedding
- Google ext-embedding-004
If you're interested in contributing or have questions about Engramic, feel free to reach out to us:
Email: info@engramic.org