jarviscore-framework 0.1.0__tar.gz

jarviscore_framework-0.1.0/.env.example

@@ -0,0 +1,146 @@
+# =============================================================================
+# JARVISCORE FRAMEWORK CONFIGURATION
+# =============================================================================
+# Copy this file to .env and fill in your values
+# All settings are optional - framework provides sensible defaults
+# Standard environment variable names (no JARVISCORE_ prefix)
+
+# =============================================================================
+# LLM CONFIGURATION (Zero-Config with Automatic Fallback)
+# =============================================================================
+# Framework tries providers in order: Claude → vLLM → Azure → Gemini
+# At least ONE provider must be configured for AutoAgent to work
+
+# --- Anthropic Claude ---
+# Standard: CLAUDE_API_KEY or ANTHROPIC_API_KEY
+# CLAUDE_API_KEY=your-anthropic-api-key
+# CLAUDE_ENDPOINT=https://api.anthropic.com  # Optional: custom endpoint
+# CLAUDE_MODEL=claude-sonnet-4
+
+# --- vLLM (Local/Self-Hosted) ---
+# Recommended for development and cost-effective production
+# LLM_ENDPOINT=http://localhost:8000
+# LLM_MODEL=Qwen/Qwen2.5-Coder-32B-Instruct
+
+# --- Azure OpenAI ---
+# Standard: AZURE_API_KEY or AZURE_OPENAI_KEY
+# AZURE_API_KEY=your-azure-openai-key
+# AZURE_ENDPOINT=https://your-resource.openai.azure.com
+# AZURE_DEPLOYMENT=gpt-4o
+# AZURE_API_VERSION=2024-02-15-preview
+
+# --- Google Gemini ---
+# GEMINI_API_KEY=your-gemini-api-key
+# GEMINI_MODEL=gemini-1.5-flash
+# GEMINI_TEMPERATURE=0.1
+# GEMINI_TIMEOUT=30.0
+
+# Common LLM Settings
+# LLM_TIMEOUT=120.0
+# LLM_TEMPERATURE=0.7
+
+# =============================================================================
+# EXECUTION SETTINGS
+# =============================================================================
+# Sandbox execution and code generation limits
+
+# Maximum execution time for generated code (seconds)
+EXECUTION_TIMEOUT=300
+
+# Maximum number of autonomous repair attempts
+MAX_REPAIR_ATTEMPTS=3
+
+# Maximum retries for failed operations
+MAX_RETRIES=3
+
+# =============================================================================
+# SANDBOX CONFIGURATION (Phase 2)
+# =============================================================================
+# Sandbox execution mode: "local" (in-process) or "remote" (service)
+# Default: local (for development)
+# Production: remote (uses JarvisCore's Azure Container Apps sandbox)
+SANDBOX_MODE=local
+
+# Remote sandbox service URL (provided by JarvisCore)
+# Azure Container Apps sandbox service - no setup required!
+# Uncomment and set SANDBOX_MODE=remote to use it
+# SANDBOX_SERVICE_URL=https://browser-task-executor.bravesea-3f5f7e75.eastus.azurecontainerapps.io
+
+# =============================================================================
+# STORAGE CONFIGURATION (Phase 1)
+# =============================================================================
+# Directory for result storage and code registry
+LOG_DIRECTORY=./logs
+
+# =============================================================================
+# P2P CONFIGURATION (For Distributed Mode)
+# =============================================================================
+# Required only if using mesh in distributed mode
+# Autonomous mode works without P2P
+
+# Enable P2P mesh networking
+P2P_ENABLED=true
+
+# Node identification
+NODE_NAME=jarviscore-node-1
+
+# Bind address and port for P2P communication
+BIND_HOST=127.0.0.1
+BIND_PORT=7946
+
+# Seed nodes to join existing mesh (comma-separated)
+# Example: 192.168.1.100:7946,192.168.1.101:7946
+# SEED_NODES=
+
+# ZeroMQ port offset (P2P messaging)
+ZMQ_PORT_OFFSET=1000
+
+# Transport type: udp, tcp, or hybrid
+TRANSPORT_TYPE=hybrid
+
+# =============================================================================
+# KEEPALIVE SETTINGS (P2P Health Monitoring)
+# =============================================================================
+
+# Enable smart keepalive (suppresses when active)
+KEEPALIVE_ENABLED=true
+
+# Keepalive interval (seconds)
+KEEPALIVE_INTERVAL=90
+
+# Keepalive timeout (seconds)
+KEEPALIVE_TIMEOUT=10
+
+# Activity suppression window (seconds)
+# If agent is actively working, suppress keepalive for this duration
+ACTIVITY_SUPPRESS_WINDOW=60
+
+# =============================================================================
+# LOGGING
+# =============================================================================
+# Log level: DEBUG, INFO, WARNING, ERROR, CRITICAL
+LOG_LEVEL=INFO
+
+# =============================================================================
+# EXAMPLES
+# =============================================================================
+
+# Example 1: Local development with vLLM
+# LLM_ENDPOINT=http://localhost:8000
+# LLM_MODEL=Qwen/Qwen2.5-Coder-32B-Instruct
+# P2P_ENABLED=false
+
+# Example 2: Production with Azure OpenAI + P2P mesh
+# AZURE_API_KEY=sk-...
+# AZURE_ENDPOINT=https://my-resource.openai.azure.com
+# AZURE_DEPLOYMENT=gpt-4o
+# P2P_ENABLED=true
+# BIND_HOST=0.0.0.0
+# BIND_PORT=7946
+# SEED_NODES=192.168.1.100:7946
+
+# Example 3: Zero-config (use defaults)
+# Just don't set any variables and framework will:
+# - Try to detect available LLM providers
+# - Use sensible defaults for all settings
+# - Work in autonomous mode (no P2P)

jarviscore_framework-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JarvisCore Contributors
+
+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.

jarviscore_framework-0.1.0/MANIFEST.in

@@ -0,0 +1,30 @@
+# Include documentation
+include README.md
+include LICENSE
+include .env.example
+include TESTING_GUIDE.md
+
+# Include all markdown docs in package
+recursive-include jarviscore/docs *.md
+
+# Include examples
+recursive-include examples *.py
+
+# Include tests (optional, for users who want to run tests)
+recursive-include tests *.py
+
+# Exclude compiled Python files
+global-exclude *.pyc
+global-exclude __pycache__
+global-exclude *.so
+global-exclude .DS_Store
+
+# Exclude development files
+exclude .gitignore
+exclude pytest.ini
+exclude benchmark_performance.py
+exclude benchmark_results.txt
+prune .venv
+prune .git
+prune logs
+prune jarviscore.egg-info

jarviscore_framework-0.1.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: jarviscore-framework
+Version: 0.1.0
+Summary: P2P distributed agent framework with LLM code generation and event-sourced state management
+Author-email: Ruth Mutua <mutuandinda82@gmail.com>, Muyukani Kizito <muyukani@prescottdata.io>
+Maintainer-email: Prescott Data <info@prescottdata.io>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/jarviscore
+Project-URL: Documentation, https://jarviscore.readthedocs.io
+Project-URL: Repository, https://github.com/yourusername/jarviscore
+Project-URL: Issues, https://github.com/yourusername/jarviscore/issues
+Keywords: agents,p2p,llm,distributed,workflow,orchestration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: swim-p2p
+Requires-Dist: pyzmq
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: anthropic>=0.18.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: google-generativeai>=0.3.0
+Requires-Dist: httpx>=0.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.5.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: jarviscore[dev]; extra == "all"
+Dynamic: license-file
+
+# JarvisCore Framework
+
+**P2P distributed agent framework with LLM code generation and production-grade state management**
+
+## Features
+
+- ✅ **Simple Agent Definition** - Write just 3 attributes, framework handles everything
+- ✅ **P2P Mesh Architecture** - Automatic agent discovery and task routing via SWIM protocol
+- ✅ **Event-Sourced State** - Complete audit trail with crash recovery
+- ✅ **Autonomous Execution** - LLM code generation with automatic repair
+
+## Installation
+
+```bash
+pip install jarviscore
+```
+
+## Setup & Validation
+
+### 1. Configure LLM Provider
+
+Copy the example config and add your API key:
+
+```bash
+cp .env.example .env
+# Edit .env and add one of: CLAUDE_API_KEY, AZURE_API_KEY, GEMINI_API_KEY, or LLM_ENDPOINT
+```
+
+### 2. Validate Installation
+
+```bash
+# Check setup
+python -m jarviscore.cli.check
+
+# Test LLM connectivity
+python -m jarviscore.cli.check --validate-llm
+
+# Run smoke test (end-to-end validation)
+python -m jarviscore.cli.smoketest
+```
+
+✅ **All checks pass?** You're ready to build agents!
+
+## Quick Start
+
+```python
+from jarviscore import Mesh
+from jarviscore.profiles import PromptDevAgent
+
+# Define agent (3 lines)
+class ScraperAgent(PromptDevAgent):
+    role = "scraper"
+    capabilities = ["web_scraping"]
+    system_prompt = "You are an expert web scraper..."
+
+# Create mesh and run workflow
+mesh = Mesh(mode="autonomous")
+mesh.add(ScraperAgent)
+await mesh.start()
+
+results = await mesh.workflow(
+    workflow_id="wf-123",
+    steps=[
+        {"id": "scrape", "task": "Scrape example.com", "role": "scraper"}
+    ]
+)
+```
+
+## Architecture
+
+JarvisCore is built on three layers:
+
+1. **Execution Layer (20%)** - Profile-specific execution (Prompt-Dev, MCP)
+2. **Orchestration Layer (60%)** - Workflow engine, dependencies, state management
+3. **P2P Layer (20%)** - Agent discovery, task routing, mesh coordination
+
+## Documentation
+
+- [User Guide](jarviscore/docs/USER_GUIDE.md) - Complete guide for AutoAgent users
+- [API Reference](jarviscore/docs/API_REFERENCE.md) - Detailed API documentation
+- [Configuration Guide](jarviscore/docs/CONFIGURATION.md) - Settings and environment variables
+- [Troubleshooting](jarviscore/docs/TROUBLESHOOTING.md) - Common issues and solutions
+- [Examples](examples/) - Working code examples
+
+## Development Status
+
+**Version:** 0.1.0 (Alpha)
+**Day 1:** Core framework foundation ✅
+
+## License
+
+MIT License - see LICENSE file for details

jarviscore_framework-0.1.0/README.md

@@ -0,0 +1,92 @@
+# JarvisCore Framework
+
+**P2P distributed agent framework with LLM code generation and production-grade state management**
+
+## Features
+
+- ✅ **Simple Agent Definition** - Write just 3 attributes, framework handles everything
+- ✅ **P2P Mesh Architecture** - Automatic agent discovery and task routing via SWIM protocol
+- ✅ **Event-Sourced State** - Complete audit trail with crash recovery
+- ✅ **Autonomous Execution** - LLM code generation with automatic repair
+
+## Installation
+
+```bash
+pip install jarviscore
+```
+
+## Setup & Validation
+
+### 1. Configure LLM Provider
+
+Copy the example config and add your API key:
+
+```bash
+cp .env.example .env
+# Edit .env and add one of: CLAUDE_API_KEY, AZURE_API_KEY, GEMINI_API_KEY, or LLM_ENDPOINT
+```
+
+### 2. Validate Installation
+
+```bash
+# Check setup
+python -m jarviscore.cli.check
+
+# Test LLM connectivity
+python -m jarviscore.cli.check --validate-llm
+
+# Run smoke test (end-to-end validation)
+python -m jarviscore.cli.smoketest
+```
+
+✅ **All checks pass?** You're ready to build agents!
+
+## Quick Start
+
+```python
+from jarviscore import Mesh
+from jarviscore.profiles import PromptDevAgent
+
+# Define agent (3 lines)
+class ScraperAgent(PromptDevAgent):
+    role = "scraper"
+    capabilities = ["web_scraping"]
+    system_prompt = "You are an expert web scraper..."
+
+# Create mesh and run workflow
+mesh = Mesh(mode="autonomous")
+mesh.add(ScraperAgent)
+await mesh.start()
+
+results = await mesh.workflow(
+    workflow_id="wf-123",
+    steps=[
+        {"id": "scrape", "task": "Scrape example.com", "role": "scraper"}
+    ]
+)
+```
+
+## Architecture
+
+JarvisCore is built on three layers:
+
+1. **Execution Layer (20%)** - Profile-specific execution (Prompt-Dev, MCP)
+2. **Orchestration Layer (60%)** - Workflow engine, dependencies, state management
+3. **P2P Layer (20%)** - Agent discovery, task routing, mesh coordination
+
+## Documentation
+
+- [User Guide](jarviscore/docs/USER_GUIDE.md) - Complete guide for AutoAgent users
+- [API Reference](jarviscore/docs/API_REFERENCE.md) - Detailed API documentation
+- [Configuration Guide](jarviscore/docs/CONFIGURATION.md) - Settings and environment variables
+- [Troubleshooting](jarviscore/docs/TROUBLESHOOTING.md) - Common issues and solutions
+- [Examples](examples/) - Working code examples
+
+## Development Status
+
+**Version:** 0.1.0 (Alpha)
+**Day 1:** Core framework foundation ✅
+
+## License
+
+MIT License - see LICENSE file for details