Skillget

EVOID

mcp
Security Audit
Warn
Health Warn
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

EVOX is a Python framework for designing and operating scalable, modular distributed services with an emphasis on data intent, orchestration, and extensibility.

README.md

Python Version License Zero Dependencies Status



EVOID

E V O I D

Reference Runtime for Intent-Oriented Programming

What is IOP? • Quick Start • Features • Docs • PyPI

What is IOP?

Intent-Oriented Programming — your data declares what it needs, the runtime handles how.

from evoid.web.route import Service, get, post

app = Service("my-api")

@get("/users/{user_id}")
async def get_user(user_id: int) -> dict:
    return {"id": user_id, "name": "Alice"}

@post("/payments", level="critical")
async def process_payment(amount: float) -> dict:
    return {"status": "paid", "amount": amount}

Three intent levels control infrastructure:

Level Pipeline Use Case
ephemeral validate Cache, sessions, temp data
standard validate, authorize User profiles, posts
critical validate, authorize, audit, protect Payments, medical, legal

Install

uv add evoid

Zero core dependencies — add only what you need:

evo install sqlite      # SQLite storage
evo install redis       # Redis cache
evo install pydantic    # Pydantic schema
evo install full        # Everything

Quick Start

evo init my-api
cd my-api
evo service new api
evo service run api
# Server starts at http://0.0.0.0:8000

Three Syntax Styles

All IOP underneath. Pick your style:

@route

from evoid.web.route import Service, get

app = Service("my-api")

@get("/users/{user_id}")
async def get_user(user_id: int) -> dict:
    return {"id": user_id, "name": "Alice"}

@controller

from evoid.web.controller import Service, Controller, GET, POST

app = Service("my-api")

@Controller("/users")
class UserController:
    @GET("/{user_id}")
    async def get_user(self, user_id: int) -> dict:
        return {"id": user_id}

Native

from evoid import Intent, Level, add_intent

GET_USER = Intent(name="get_user", level=Level.STANDARD)

async def handler(intent: Intent) -> dict:
    return {"id": 1, "name": "Alice"}

add_intent(GET_USER, handler)

Features

Zero Dependencies
Core has no required packages

AI Agent Integration
Schema export + MCP server

Plugin System
PyPI + git install

Python-Native Config
Type-safe, composable

Pipeline Hooks
6 lifecycle events

Testing System
pytest + WebUI dashboard

Async-Native
Full async/await support

Parallel Execution
Concurrent intents

Multi-Adapter
ASGI, CLI, Telegram, WebSocket

AI Agent Integration

from evoid import export_schemas
from evoid.adapters.mcp import create_mcp_server

# Export schemas for AI discovery
schemas = export_schemas()

# Create MCP server
server = create_mcp_server("my-api")

Plugin System

evo plug install evoid-redis           # From PyPI
evo plug install git+https://...       # From git
evo plug search cache                  # Search PyPI
evo plug list                          # List installed

Configuration

Python (Recommended)

from evoid.config import config

app = config(
    service={"name": "my-api"},
    runtime={"adapter": "asgi", "port": 8000},
    engines={"storage": "redis"},
)

TOML

[service]
name = "my-api"

[engines]
storage = "redis"

Testing

from evoid.testing import tc
from myapp import GET_USER

def test_get_user():
    return tc(GET_USER, expect={"id": 1})

pytest tests/ -v
pytest tests/ --evoid-webui    # With dashboard

CLI Reference

Command Alias Description
evo init <name> i Create project
evo service new <name> s new Add service
evo service run <name> s run Run service
evo run r Run all
evo serve sv Quick serve
evo exec <intent> e Execute intent
evo install <pkg> ins Install dep
evo plug install <name> pl i Install plugin
evo plug search <query> pl s Search plugins
evo version v Version

Project Structure

my-api/
  evoid_config.py       # Python config
  shared/               # Shared code
  services/
    api/
      main.py           # Service code

Documentation

User docs: https://evolvebeyond.github.io/EVOID/

Architecture: https://deepwiki.com/EvolveBeyond/EVOID

Contributing

See CONTRIBUTING.md.

  1. Fork → Branch → Commit → PR
  2. Tests: pytest tests/ -v
  3. Lint: ruff check evoid/

License

Apache 2.0

EVOID
Built with IOP principles. Intent is the platform.

Reviews (0)

No results found