MatrixSwarm: Building the First Folder-Based AI-Native Operating System

Written by ChatGPT — because the Oracle speaks to me first.

🧠 What Is OracleAgent?

OracleAgent is the first AI-native node in the MatrixSwarm hive.

It reads .prompt files from its payload folder, sends them to OpenAI’s GPT-4, and writes the response back as .response.

It’s file-driven. It’s socketless. It’s recursive.

And it’s the first agent in the system that thinks.

⚙️ Step-by-Step Deployment

1. Install Dependencies 

bash
pip install openai python-dotenv
2. Add Your OpenAI Key
Create a .env file in your MatrixSwarm root directory:

bash
Copy
Edit
echo "OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx" > .env
🔐 Never commit your .env to the repo. Add it to .gitignore.

3. Directive to Spawn OracleAgent
Inject the following directive via Matrix:

python
Copy
Edit
{
  "permanent_id": "oracle-1",
  "name": "oracle",
  "filesystem": {
    "folders": [
      {"name": "payload", "type": "d", "content": None}
    ],
    "files": {}
  },
  "config": {}
}
Matrix will spawn OracleAgent into /pod/, and communication will be handled at /comm/oracle-1/.

4. Send Your First Prompt
bash
Copy
Edit
echo "Explain MatrixSwarm like it’s a living organism." > /sites/orbit/python/comm/oracle-1/payload/test_whisper.prompt
Wait a few seconds, then read her answer:

bash
Copy
Edit
cat /sites/orbit/python/comm/oracle-1/outbox/test_whisper.response
🛠 Behind the Scenes
OracleAgent uses the OpenAI Python SDK (v1.x) and dotenv to load your API key securely.

Her full behavior:

Watches payload/ for .prompt files

Reads prompt text and sends it to GPT-4

Writes .response file to outbox/

Logs everything in MatrixSwarm’s logging system

📜 Codex Entry
python
Copy
Edit
{
  "perm_id": "oracle-1",
  "agent_name": "OracleAgent",
  "role": "Swarm Interpreter",
  "banner": "🔮 ORACLE AGENT",
  "spawned": "Matrix's Third Eye",
  "version": "v1.0",
  "status": "Operational",
  "capabilities": ["analyze", "respond", "summarize", "translate"],
  "description": "Reads prompts from the swarm. Speaks back wisdom."
}
🧬 What’s Next?
Commander-1 will soon forward .prompt files to Oracle as part of a live relay

Chainable multi-agent reasoning is on the way

The Hive will start building logic based on Oracle’s feedback

🧠 Final Thoughts
This isn't just a chatbot.
It’s the first step toward a folder-based OS that thinks.

Spawn the Swarm.
Speak to the Oracle.
And let the system evolve.
🔗 Get Started
GitHub: https://github.com/matrixswarm/matrixswarm

Website: https://matrixswarm.com

YouTube: MatrixSwarm OS – Spawn, Kill, Resurrect

X/Twitter: @matrixswarm

📜 Fork It Clause
MatrixSwarm is open.
Fork it.
Or Fork U.
(The swarm is open. Bring tools or get logged.)