ZAI Core โ A lightweight modular AI framework with persistent memory.
Project description
๐งฉ Overview
ZAI Core is a modular Python-based AI framework built by Muhammad Zaidan.
Version v0.2.0 introduces Persistent Memory, allowing ZAI Core to remember what it learns โ permanently.
โNow your AI remembers โ even after shutdown.โ
โ๏ธ Features (v0.2.0)
- ๐ง Persistent Brain โ Memory is saved in
zai_memory.json - ๐พ Auto Save System โ Every
learn()updates memory instantly - ๐ Recall Intelligence โ Retrieve old knowledge anytime
- ๐งฉ Forget & Wipe โ Erase single or all stored memories
- ๐ง CLI Mode โ Use ZAI Core directly from terminal
- ๐ง Configurable Path โ Custom memory file location
๐งฑ Folder Structure
./ZAI-Core/
โ
โโโ ./zaicore/
โ โโโ ./__init__.py
โ โโโ ./__main__.py # CLI Interface
โ โโโ ./core.py # Main AI Core Logic (Persistent Memory)
โ โโโ ./utils/
โ โโโ ./__init__.py
โ โโโ ./data_handler.py # Memory I/O Handler
โ
โโโ ./docs/
โ โโโ ./architecture.md
โ
โโโ ./setup.py
โโโ ./setup.cfg
โโโ ./LICENSE
โโโ ./README.md
๐ป Quick Start
Installation
pip install zaicore
Example (Python)
from zaicore import ZAICore
ai = ZAICore()
ai.learn("mission", "to build adaptive AI frameworks")
ai.learn("creator", "Muhammad Zaidan")
ai.recall("mission")
ai.recall("creator")
Output:
๐ง ZAI Core v0.2.0 initialized โ Persistent Brain Online.
[Learning] Stored: mission -> to build adaptive AI frameworks
[Learning] Stored: creator -> Muhammad Zaidan
[Recall] mission: to build adaptive AI frameworks
[Recall] creator: Muhammad Zaidan
๐ง CLI Mode
You can now talk to ZAI Core directly from your terminal.
python -m zaicore
Example Interaction:
๐ Launching ZAI Core v0.2.0 โ CLI Mode
๐ง ZAI Core v0.2.0 initialized โ Persistent Brain Online.
Type 'exit' to quit.
๐ง > learn name = Zaidan
[Learning] Stored: name -> Zaidan
๐ง > recall name
[Recall] name: Zaidan
๐ง > forget name
[Forget] Key 'name' removed from memory.
๐ง > wipe
๐งน All memory wiped clean.
๐ง > exit
๐ Shutting down ZAI Core...
โ๏ธ Developer Notes
ZAI Core stores all learned data in a file called:
./zai_memory.json
To reset everything manually:
rm zai_memory.json
๐งฉ Development Roadmap
| Version | Feature | Status |
|---|---|---|
| v0.1.0 | Basic AI learn & recall system | โ Released |
| v0.2.0 | Persistent Brain + CLI Mode | ๐ง Active |
| v0.3.0 | Chat Interface + Plugin Loader | ๐ Planned |
๐งโ๐ป Author
Muhammad Zaidan Faiz
๐ผ LinkedIn
๐ GitHub
๐ง muhammadzaidanfaiz8@gmail.com
๐ License
Released under the MIT License โ free to learn, modify, and expand.
โญ ZAI Core โ The brain that never forgets.
๐ฌ โDonโt just build AI. Build something that learns with you.โ
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 zaicore-0.2.1.tar.gz.
File metadata
- Download URL: zaicore-0.2.1.tar.gz
- Upload date:
- Size: 5.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
70c7fd6d3e23359c8548f4e140c6ac46fea1935910400df04f390e3a911fb211
|
|
| MD5 |
3086d0d05969c16ca7a679f2f53a5491
|
|
| BLAKE2b-256 |
850edbe5d7ec3331398c6cfd187f27fa6b1bd636587a1db624ea181428c5e224
|
File details
Details for the file zaicore-0.2.1-py3-none-any.whl.
File metadata
- Download URL: zaicore-0.2.1-py3-none-any.whl
- Upload date:
- Size: 5.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
804856bff2124f1b2b0afccb3c668fd73f4d056dceaf9705538bef067e7fdf33
|
|
| MD5 |
0fb0b3b8099447b26858a9979362f87a
|
|
| BLAKE2b-256 |
ef739bdcf9d0fb6ffda2d23e3b2cc3147223c4d92e4add79dcc47292f713a34c
|