chore: consolidate Syslog Solution code into unified repository structure

- Moved scattered scripts, templates, and documentation into organized directories (applications/, scripts/, assets/).
- Updated .gitignore to strictly exclude secrets, state files, and IDE configs.
- Added comprehensive README.md outlining repository structure and best practices.
- Preserved all existing documentation and technical architecture files.
- Prepared infrastructure/ for AWS Org and Proxmox Terraform management.
This commit is contained in:
2026-05-07 11:40:02 +00:00
parent d47dc23b81
commit 05eccd5b53
51 changed files with 1690 additions and 1476 deletions
@@ -1,70 +0,0 @@
1|# 04 - Autonomous AI Agents — Home
2|**Purpose:** Research and implementation of autonomous agent workflows.
3|
4|## Overview
5|
6|Autonomous AI agents can execute multi-step tasks independently, learn from experience, and make decisions based on context. This section covers advanced orchestration patterns for production-grade agent systems.
7|
8|## Key Capabilities
9|
10|### **Multi-Agent Collaboration**
11|- Role-based agent delegation
12|- Cross-agent memory sharing
13|- Conflict resolution protocols
14|- Distributed task execution
15|
16|### **Autonomous Behaviors**
17|- Self-correction loops
18|- Error recovery mechanisms
19|- Performance optimization
20|- Adaptive resource allocation
21|
22|### **Advanced Patterns**
23|- Agent swarms (10+ coordinated agents)
24|- Continuous learning cycles
25|- Human-in-the-loop intervention points
26|- Audit trails and observability
27|
28|## Implementation Strategies
29|
30|### **Sequential Workflows**
31|```python
32|agent1.run(task="Research market")
33|agent2.run(task="Analyze data")
34|agent3.run(task="Generate report")
35|```
36|
37|### **Parallel Workflows**
38|```python
39|results = await asyncio.gather(
40| agent1.run(task="A"),
41| agent2.run(task="B"),
42| agent3.run(task="C")
43|)
44|```
45|
46|### **Feedback Loops**
47|```python
48|while not agent.is_satisfied(result):
49| agent.improve(result)
50| result = agent.execute(prompt)
51|```
52|
53|## Use Cases
54|
55|- Market research automation
56|- Multi-step data analysis pipelines
57|- Customer support orchestration
58|- Content generation workflows
59|- Codebase refactoring agents
60|
61|## Related Frameworks
62|
63|- **[OpenClaw](../02\ -\ OpenClaw\ Framework/)** — Agent orchestration platform
64|- **[MCP](../03\ -\ MCP\ \(Model\ Context\ Protocol\)/)** — Tool integration layer
65|- **[OpenMAIC](../06\ -\ OpenMAIC\ Education/)** — Educational resources
66|
67|---
68|
69|*Advanced agent patterns for Jerome & Theodore's complex automation projects.*
70|
@@ -1,53 +0,0 @@
1|# 01 - Claude Code & Opencode — Home
2|**Purpose:** Agent framework tutorials and best practices for Claude Code and OpenCode CLI.
3|
4|## Overview
5|
6|This section provides practical guides for deploying and managing AI coding agents using Claude Code and OpenCode CLI tools.
7|
8|## Contents
9|
10|### **Claude Code**
11|- Quick start and configuration
12|- Integration with IDEs
13|- Custom agent definitions
14|- Security best practices
15|
16|### **OpenCode**
17|- CLI setup and usage
18|- Extending with custom commands
19|- Multi-agent orchestration
20|- Production deployment patterns
21|
22|### **Best Practices**
23|- Context window management
24|- Agent sandboxing rules
25|- Error handling patterns
26|- Performance optimization
27|
28|## Quick Start
29|
30|```bash
31|# Install OpenCode CLI
32|pip install opencode-cli
33|
34|# Configure API keys
35|export OPENAI_API_KEY="***"
36|
37|# Run Claude Code
38|opencode run "Analyze this codebase for security issues"
39|
40|# Create custom agent
41|opencode agent create --name my-helper --template best-practices
42|```
43|
44|## Related Frameworks
45|
46|- **[MCP (Model Context Protocol)](../03\ -\ MCP\ \(Model\ Context\ Protocol\)/)** — Tool integration
47|- **[OpenClaw Framework](../02\ -\ OpenClaw\ Framework/)** — Multi-agent orchestration
48|- **[Autonomous AI Agents](../04\ -\ Autonomous\ AI\ Agents/)** — Advanced workflows
49|
50|---
51|
52|*Practical guides for Jerome & Theodore to implement AI coding agents in their daily workflow.*
53|
@@ -1,87 +0,0 @@
1|# 02 - MCP (Model Context Protocol) — Home
2|**Purpose:** MCP integration guides and implementation examples.
3|
4|## What is MCP?
5|Model Context Protocol (MCP) is a standardized interface for connecting LLMs to external tools, data sources, and services.
6|
7|## MCP Benefits
8|- **Unified interface** for tool integration
9|- **Hot-swappable** tool providers
10|- **Standardized** input/output schemas
11|- **Type-safe** API definitions
12|
13|## Core Concepts
14|
15|### Tools
16|External capabilities exposed to the model:
17|- File system access
18|- Database queries
19|- API endpoints
20|- Custom business logic
21|
22|### Resources
23|Data sources the model can read:
24|- Documents
25|- Configuration files
26|- Real-time data feeds
27|- Knowledge bases
28|
29|### Prompts
30|Pre-defined interaction templates:
31|- Task initiation patterns
32|- System prompt variations
33|- Role-definition templates
34|
35|## Quick Start
36|
37|```bash
38|# Install MCP server
39|pip install mcp-server-filesystem mcp-server-sqlite
40|
41|# Start a filesystem MCP server
42|mcp-server-filesystem --path /path/to/allowed/directory
43|
44|# Connect via client
45|from mcp import ClientSession, StdioServerParameters
46|
47|async with ClientSession(
48| stdio_server_parameters=StdioServerParameters(
49| command="mcp-server-filesystem",
50| args=["--path", "/path/to/allowed/directory"]
51| )
52|) as session:
53| # List available tools
54| tools = await session.list_tools()
55|```
56|
57|## Available MCP Servers
58|
59|- **Filesystem:** Access documents and configuration files
60|- **SQL databases:** Query relational databases safely
61|- **API Gateway:** Connect to REST/GraphQL endpoints
62|- **Custom Business Logic:** Integrate internal tools and services
63|
64|## Security Considerations
65|
66|- **Path whitelisting:** Only allow specific directories
67|- **Query rate limiting:** Prevent resource exhaustion
68|- **Input sanitization:** Validate all user inputs
69|- **Token-based access:** Require authentication for sensitive operations
70|
71|## Use Cases
72|
73|- **Document analysis:** Read and process large document collections
74|- **Database queries:** Extract insights from operational databases
75|- **API orchestration:** Coordinate across multiple external services
76|- **Code generation:** Write and execute code safely
77|
78|## References
79|
80|- [MCP Specification](https://modelcontextprotocol.io)
81|- [MCP Server Implementations](https://github.com/modelcontextprotocol/servers)
82|- [Integration Examples](../03%20-%20AI%20AGENTS%20&%20LEARNING/02%20-%20OpenClaw%20Framework/)
83|
84|---
85|
86|*MCP integrates seamlessly with OpenClaw agent orchestration for scalable AI applications.*
87|
@@ -1,59 +0,0 @@
1|# OpenClaw Framework — Home
2|**Purpose:** Complete guide to setting up and using the OpenClaw agent orchestration framework.
3|
4|## What is OpenClaw?
5|OpenClaw provides a powerful framework for orchestrating AI agents, enabling multi-agent collaboration, task delegation, and complex workflow automation.
6|
7|## Quick Start
8|
9|### Installation
10|```bash
11|# Clone the repository
12|git clone https://github.com/openclaw/openclaw.git
13|cd openclaw
14|
15|# Install dependencies
16|pip install -r requirements.txt
17|
18|# Configure API keys
19|export OPENCLAW_API_KEY="***"
20|```
21|
22|### Basic Usage
23|```python
24|from openclaw import AgentOrchestrator
25|
26|# Create an orchestrator
27|orchestrator = AgentOrchestrator()
28|
29|# Define agent roles
30|agents = {
31| "researcher": Agent(role="researcher"),
32| "analyst": Agent(role="analyst"),
33| "writer": Agent(role="writer")
34|}
35|
36|# Run a multi-agent workflow
37|result = orchestrator.run_task(
38| task="Write market analysis report",
39| agents=agents
40|)
41|```
42|
43|## Framework Components
44|
45|- **Agent Registry:** Pool of specialized agents
46|- **Task Dispatcher:** Routes tasks to appropriate agents
47|- **Collaboration Layer:** Enables agent-to-agent communication
48|- **Orchestration Engine:** Coordinates complex workflows
49|
50|## Use Cases
51|
52|- Market research automation
53|- Content generation pipelines
54|- Multi-step data analysis
55|- Autonomous decision making
56|
57|---
58|
59|*For advanced usage, refer to the Advanced Usage guide and API Reference documentation.*
@@ -1,92 +1,92 @@
1|# 06 - OpenMAIC Education — Home
2|**Purpose:** OpenMAIC (Open Multi-Agent AI Collaboration) educational resources and curriculum.
3|
4|## What is OpenMAIC?
5|
6|OpenMAIC (Open Multi-Agent AI Collaboration) is an educational framework designed to help teams understand and implement multi-agent AI systems. It provides:
7|
8|- **Structured Curriculum:** From fundamentals to advanced patterns
9|- **Hands-on Exercises:** Real-world practice through coding challenges
10|- **Community Learning:** Collaborative problem-solving and knowledge sharing
11|
12|## Curriculum Structure
13|
14|### **Module 1: Fundamentals**
15|- Introduction to multi-agent systems
16|- Agent role definition and capabilities
17|- Basic orchestration patterns
18|- Simple agent collaboration examples
19|
20|### **Module 2: Advanced Collaboration**
21|- Complex workflow design
22|- Context sharing between agents
23|- Error handling and recovery
24|- Performance optimization
25|
26|### **Module 3: Production Patterns**
27|- Scaling to 10+ agents
28|- Monitoring and diagnostics
29|- Security best practices
30|- Cost optimization strategies
31|
32|### **Module 4: Real-World Applications**
33|- Market analysis automation
34|- Customer support orchestration
35|- Content pipeline automation
36|- Data processing workflows
37|
38|## Getting Started
39|
40|```bash
41|# Step 1: Install OpenMAIC
42|pip install openmaic-core openmaic-visualizer
43|
44|# Step 2: Clone learning resources
45|git clone https://github.com/sysloggh/openmaic-learning.git
46|cd openmaic-learning/modules
47|
48|# Step 3: Start with Module 1
49|python module01_fundamentals.py
50|```
51|
52|## Example Agent Collaboration
53|
54|```python
55|from openmaic.core import Orchestrator, Agent
56|
57|# Initialize orchestrator
58|orchestrator = Orchestrator(
59| max_agents=3,
60| collaboration_mode="sequential"
61|)
62|
63|# Create agents
64|researcher = Agent(name="researcher", role="Research Assistant")
65|analyst = Agent(name="analyst", role="Data Analysis")
66|writer = Agent(name="writer", role="Content Generator")
67|
68|# Execute workflow
69|result = orchestrator.run([
70| researcher.run(task="Research AI trends"),
71| analyst.run(task="Analyze market data"),
72| writer.run(task="Write market report")
73|])
74|```
75|
76|## Use Cases at Syslog GH/LLC
77|
78|- **Market Research Automation:** Automatically gather and analyze SMB AI adoption data
79|- **Content Generation:** Create service descriptions and case studies
80|- **Customer Support:** Multi-agent Q&A for client inquiries
81|- **Code Review Agents:** Automated code quality checks
82|
83|## Related Resources
84|
85|- **[Autonomous AI Agents](../04\ -\ Autonomous\ AI\ Agents/)** — Advanced workflows
86|- **[Claude Code & Opencode](../01\ -\ Claude\ Code\ \&\ Opencode/)** — Practical implementation
87|- **[MCP (Model Context Protocol)](../03\ -\ MCP\ \(Model\ Context\ Protocol\)/)** — Tool integration
88|
89|---
90|
91|*Perfect for Jerome & Theodore's strategy sessions on AI agent frameworks and multi-agent collaboration patterns. This curriculum supports our mission to educate SMBs on AI adoption while building our own agent capabilities.*
92|
1|# 06 - OpenMAIC Education — Home
2|**Purpose:** OpenMAIC (Open Multi-Agent AI Collaboration) educational resources and curriculum.
3|
4|## What is OpenMAIC?
5|
6|OpenMAIC (Open Multi-Agent AI Collaboration) is an educational framework designed to help teams understand and implement multi-agent AI systems. It provides:
7|
8|- **Structured Curriculum:** From fundamentals to advanced patterns
9|- **Hands-on Exercises:** Real-world practice through coding challenges
10|- **Community Learning:** Collaborative problem-solving and knowledge sharing
11|
12|## Curriculum Structure
13|
14|### **Module 1: Fundamentals**
15|- Introduction to multi-agent systems
16|- Agent role definition and capabilities
17|- Basic orchestration patterns
18|- Simple agent collaboration examples
19|
20|### **Module 2: Advanced Collaboration**
21|- Complex workflow design
22|- Context sharing between agents
23|- Error handling and recovery
24|- Performance optimization
25|
26|### **Module 3: Production Patterns**
27|- Scaling to 10+ agents
28|- Monitoring and diagnostics
29|- Security best practices
30|- Cost optimization strategies
31|
32|### **Module 4: Real-World Applications**
33|- Market analysis automation
34|- Customer support orchestration
35|- Content pipeline automation
36|- Data processing workflows
37|
38|## Getting Started
39|
40|```bash
41|# Step 1: Install OpenMAIC
42|pip install openmaic-core openmaic-visualizer
43|
44|# Step 2: Clone learning resources
45|git clone https://github.com/sysloggh/openmaic-learning.git
46|cd openmaic-learning/modules
47|
48|# Step 3: Start with Module 1
49|python module01_fundamentals.py
50|```
51|
52|## Example Agent Collaboration
53|
54|```python
55|from openmaic.core import Orchestrator, Agent
56|
57|# Initialize orchestrator
58|orchestrator = Orchestrator(
59| max_agents=3,
60| collaboration_mode="sequential"
61|)
62|
63|# Create agents
64|researcher = Agent(name="researcher", role="Research Assistant")
65|analyst = Agent(name="analyst", role="Data Analysis")
66|writer = Agent(name="writer", role="Content Generator")
67|
68|# Execute workflow
69|result = orchestrator.run([
70| researcher.run(task="Research AI trends"),
71| analyst.run(task="Analyze market data"),
72| writer.run(task="Write market report")
73|])
74|```
75|
76|## Use Cases at Syslog GH/LLC
77|
78|- **Market Research Automation:** Automatically gather and analyze SMB AI adoption data
79|- **Content Generation:** Create service descriptions and case studies
80|- **Customer Support:** Multi-agent Q&A for client inquiries
81|- **Code Review Agents:** Automated code quality checks
82|
83|## Related Resources
84|
85|- **[Autonomous AI Agents](../04\ -\ Autonomous\ AI\ Agents/)** — Advanced workflows
86|- **[Claude Code & Opencode](../01\ -\ Claude\ Code\ \&\ Opencode/)** — Practical implementation
87|- **[MCP (Model Context Protocol)](../03\ -\ MCP\ \(Model\ Context\ Protocol\)/)** — Tool integration
88|
89|---
90|
91|*Perfect for Jerome & Theodore's strategy sessions on AI agent frameworks and multi-agent collaboration patterns. This curriculum supports our mission to educate SMBs on AI adoption while building our own agent capabilities.*
92|
@@ -1,19 +0,0 @@
1|# 03 - AI AGENTS & LEARNING — Home
2|**Purpose:** AI agent frameworks, learning resources, and implementation guides.
3|
4|## Contents
5|
6|### **01 - Claude Code & Opencode** — Agent framework tutorials and best practices.
7|
8|### **02 - OpenClaw Framework** — Open-source agent orchestration platform setup and usage.
9|
10|### **03 - MCP (Model Context Protocol)** — Integration guides for connecting LLMs to external tools and data sources.
11|
12|### **04 - Autonomous AI Agents** — Research and implementation of autonomous agent workflows.
13|
14|### **05 - Agent Research & Learning** — Papers, YouTube tutorials, podcasts, and general learning resources.
15|
16|---
17|
18|*This section pairs conceptual guides with their implementation scripts for rapid prototyping and deployment.*
19|
@@ -1,43 +0,0 @@
1|# 04 - Qwen3.5 Model Setup — Home
2|**Purpose:** Installation and configuration guides for Qwen3.5 model variants.
3|
4|## Available Models
5|
6|### **Qwen3.5-MoE (Mixture of Experts)** — Optimized for production inference with dynamic expert routing.
7|
8|### **Qwen3.5-Base** — Standard dense model variant.
9|
10|### **Qwen3.5-FineTuned** — Domain-specific fine-tuned variants.
11|
12|## GPU Compatibility
13|
14|- **AMD Strix Halo** — See [AMD GPU Passthrough Guide](../03\ -\ AMD\ GPU\ Passthrough/00\ -\ AMD\ GPU\ Passthrough.md)
15|- **NVIDIA RTX 4090** — Standard CUDA setup
16|- **Multi-GPU Clusters** — Distributed inference setup
17|
18|## Quick Start
19|
20|### Install Qwen3.5-MoE via Ollama
21|```bash
22|ollama pull qwen3.5:250b-moe
23|ollama serve
24|
25|# Run locally at 192.168.68.8:8080
26|ollama run qwen3.5:250b-moe "What are the top AI trends for 2026?"
27|```
28|
29|### Advanced Configuration
30|
31|For production deployments with dynamic expert selection:
32|- See `/60\ -\ Syslog/02\ -\ TECHNICAL\ INFRASTRUCTURE/04\ -\ Qwen3.5\ Model\ Setup/01\ -\ Qwen3.5-MoE\ Configuration.md`
33|- GPU passthrough: `/60\ -\ Syslog/02\ -\ TECHNICAL\ INFRASTRUCTURE/03\ -\ AMD\ GPU\ Passthrough/00\ -\ AMD\ GPU\ Passthrough.md`
34|
35|## Scripts
36|
37|- `vulkan-qwen35-moe-setup.sh` — Complete setup script for Qwen3.5-MoE with Vulkan backend
38|- `qwen35-moe-inference-config.sh` — Production inference configuration script
39|
40|---
41|
42|*For AMD GPU-specific setup, refer to the AMD GPU Passthrough guide.*
43|
@@ -1,54 +0,0 @@
1|# 05 - Agent Research & Learning — Home
2|**Purpose:** Research papers, tutorials, and resources for AI agent development.
3|
4|## Overview
5|
6|Stay current with the latest developments in AI agent technology through curated research, tutorials, and community resources.
7|
8|## Learning Resources
9|
10|### **Academic Papers**
11|- **Multi-Agent Systems:** Foundations and applications
12|- **Reinforcement Learning for Agents:** Q-learning, PPO, GRPO
13|- **Agent Communication Protocols:** FIPA, ACL, custom protocols
14|- **Tool Learning:** In-context learning for tool selection
15|
16|### **Video Tutorials**
17|- **YouTube Series:** Deep dives into agent architectures
18|- **Conference Keynotes:** NeurIPS, ICML, ICLR talks
19|- **Hands-on Labs:** Step-by-step implementation guides
20|
21|### **Podcasts**
22|- **AI Agent Deep Dives:** Interviews with researchers
23|- **Industry Applications:** Real-world use cases
24|- **Future Trends:** Expert predictions and analysis
25|
26|### **Community Resources**
27|- **GitHub Repositories:** Open-source agent frameworks
28|- **Discord Servers:** Community support and collaboration
29|- **Conferences:** Annual meetups and workshops
30|
31|## Recommended Reading
32|
33|1. **"Language Models as Zero-Shot Planners"** — arXiv:2106.04415
34|2. **"ReAct: Synergizing Reasoning and Acting"** — arXiv:2210.03629
35|3. **"Tool Learning: LLMs Learning to Call External APIs"** — arXiv:2302.04762
36|4. **"Multi-Agent Collaboration: A Survey"** — arXiv:2310.08056
37|
38|## Stay Updated
39|
40|- **arXiv Alerts:** Set up daily/weekly digests for "agent" papers
41|- **Twitter/X:** Follow key researchers and AI labs
42|- **GitHub Topics:** #ai-agents, #multi-agent, #agent-orchestration
43|- **Newsletter:** AI Weekly, Towards Data Science, ML News
44|
45|## Related Frameworks
46|
47|- **[Claude Code & Opencode](../01\ -\ Claude\ Code\ \&\ Opencode/)** — Practical implementation
48|- **[OpenClaw Framework](../02\ -\ OpenClaw\ Framework/)** — Production orchestration
49|- **[OpenMAIC Education](../06\ -\ OpenMAIC\ Education/)** — Structured learning
50|
51|---
52|
53|*Continuous learning resources for Jerome & Theodore to stay ahead in AI agent development.*
54|