aimarket-metis 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (140) hide show
  1. aimarket_metis-0.2.0/PKG-INFO +166 -0
  2. aimarket_metis-0.2.0/README.md +139 -0
  3. aimarket_metis-0.2.0/aimarket_metis.egg-info/PKG-INFO +166 -0
  4. aimarket_metis-0.2.0/aimarket_metis.egg-info/SOURCES.txt +138 -0
  5. aimarket_metis-0.2.0/aimarket_metis.egg-info/dependency_links.txt +1 -0
  6. aimarket_metis-0.2.0/aimarket_metis.egg-info/entry_points.txt +7 -0
  7. aimarket_metis-0.2.0/aimarket_metis.egg-info/requires.txt +14 -0
  8. aimarket_metis-0.2.0/aimarket_metis.egg-info/top_level.txt +1 -0
  9. aimarket_metis-0.2.0/metis/__init__.py +7 -0
  10. aimarket_metis-0.2.0/metis/agents/__init__.py +0 -0
  11. aimarket_metis-0.2.0/metis/agents/capability.py +236 -0
  12. aimarket_metis-0.2.0/metis/agents/council.py +144 -0
  13. aimarket_metis-0.2.0/metis/agents/diversity.py +73 -0
  14. aimarket_metis-0.2.0/metis/agents/loop.py +110 -0
  15. aimarket_metis-0.2.0/metis/agents/moa.py +107 -0
  16. aimarket_metis-0.2.0/metis/api/__init__.py +1 -0
  17. aimarket_metis-0.2.0/metis/api/app.py +163 -0
  18. aimarket_metis-0.2.0/metis/api/auth.py +62 -0
  19. aimarket_metis-0.2.0/metis/api/bridge.py +135 -0
  20. aimarket_metis-0.2.0/metis/api/ecosystem.py +340 -0
  21. aimarket_metis-0.2.0/metis/api/observability_routes.py +55 -0
  22. aimarket_metis-0.2.0/metis/api/openai_compat.py +138 -0
  23. aimarket_metis-0.2.0/metis/api/rate_limit.py +61 -0
  24. aimarket_metis-0.2.0/metis/api/schemas.py +47 -0
  25. aimarket_metis-0.2.0/metis/cli.py +196 -0
  26. aimarket_metis-0.2.0/metis/config.py +225 -0
  27. aimarket_metis-0.2.0/metis/coordinator_server.py +175 -0
  28. aimarket_metis-0.2.0/metis/distributed/__init__.py +15 -0
  29. aimarket_metis-0.2.0/metis/distributed/cli.py +124 -0
  30. aimarket_metis-0.2.0/metis/distributed/coordinator.py +148 -0
  31. aimarket_metis-0.2.0/metis/distributed/node.py +50 -0
  32. aimarket_metis-0.2.0/metis/distributed/protocol.py +52 -0
  33. aimarket_metis-0.2.0/metis/distributed/registry.py +234 -0
  34. aimarket_metis-0.2.0/metis/distributed/remote_provider.py +131 -0
  35. aimarket_metis-0.2.0/metis/distributed/security.py +121 -0
  36. aimarket_metis-0.2.0/metis/distributed/server.py +175 -0
  37. aimarket_metis-0.2.0/metis/economy/__init__.py +32 -0
  38. aimarket_metis-0.2.0/metis/economy/bridge.py +59 -0
  39. aimarket_metis-0.2.0/metis/economy/config.py +32 -0
  40. aimarket_metis-0.2.0/metis/economy/cost.py +46 -0
  41. aimarket_metis-0.2.0/metis/economy/meter.py +136 -0
  42. aimarket_metis-0.2.0/metis/economy/tracked.py +56 -0
  43. aimarket_metis-0.2.0/metis/env_compat.py +19 -0
  44. aimarket_metis-0.2.0/metis/exoskeleton.py +700 -0
  45. aimarket_metis-0.2.0/metis/gates/__init__.py +71 -0
  46. aimarket_metis-0.2.0/metis/knowledge/__init__.py +13 -0
  47. aimarket_metis-0.2.0/metis/knowledge/cli.py +32 -0
  48. aimarket_metis-0.2.0/metis/knowledge/config.py +17 -0
  49. aimarket_metis-0.2.0/metis/knowledge/experience.py +53 -0
  50. aimarket_metis-0.2.0/metis/knowledge/failures.py +57 -0
  51. aimarket_metis-0.2.0/metis/knowledge/store.py +183 -0
  52. aimarket_metis-0.2.0/metis/mcp/__init__.py +17 -0
  53. aimarket_metis-0.2.0/metis/mcp/client.py +151 -0
  54. aimarket_metis-0.2.0/metis/mcp/config.py +56 -0
  55. aimarket_metis-0.2.0/metis/mcp/discovery.py +39 -0
  56. aimarket_metis-0.2.0/metis/mcp/registry.py +76 -0
  57. aimarket_metis-0.2.0/metis/mcp/sse.py +99 -0
  58. aimarket_metis-0.2.0/metis/memory/__init__.py +0 -0
  59. aimarket_metis-0.2.0/metis/memory/store.py +141 -0
  60. aimarket_metis-0.2.0/metis/models/__init__.py +0 -0
  61. aimarket_metis-0.2.0/metis/models/anthropic.py +79 -0
  62. aimarket_metis-0.2.0/metis/models/provider.py +271 -0
  63. aimarket_metis-0.2.0/metis/modules/__init__.py +17 -0
  64. aimarket_metis-0.2.0/metis/modules/registry.py +286 -0
  65. aimarket_metis-0.2.0/metis/observability/__init__.py +43 -0
  66. aimarket_metis-0.2.0/metis/observability/cli.py +145 -0
  67. aimarket_metis-0.2.0/metis/observability/config.py +41 -0
  68. aimarket_metis-0.2.0/metis/observability/logging/__init__.py +13 -0
  69. aimarket_metis-0.2.0/metis/observability/logging/audit.py +106 -0
  70. aimarket_metis-0.2.0/metis/observability/logging/module_logger.py +130 -0
  71. aimarket_metis-0.2.0/metis/observability/logging/pipeline_events.py +121 -0
  72. aimarket_metis-0.2.0/metis/observability/logging/tracer.py +379 -0
  73. aimarket_metis-0.2.0/metis/observability/reliability/__init__.py +1 -0
  74. aimarket_metis-0.2.0/metis/observability/reliability/circuit_breaker.py +88 -0
  75. aimarket_metis-0.2.0/metis/observability/reliability/detector.py +80 -0
  76. aimarket_metis-0.2.0/metis/observability/reliability/retry.py +86 -0
  77. aimarket_metis-0.2.0/metis/observability/trace_store.py +98 -0
  78. aimarket_metis-0.2.0/metis/pipeline/__init__.py +15 -0
  79. aimarket_metis-0.2.0/metis/pipeline/agreement.py +93 -0
  80. aimarket_metis-0.2.0/metis/pipeline/depth.py +97 -0
  81. aimarket_metis-0.2.0/metis/pipeline/escalation.py +35 -0
  82. aimarket_metis-0.2.0/metis/rag/__init__.py +0 -0
  83. aimarket_metis-0.2.0/metis/rag/agentic.py +62 -0
  84. aimarket_metis-0.2.0/metis/router/__init__.py +0 -0
  85. aimarket_metis-0.2.0/metis/router/classifier.py +76 -0
  86. aimarket_metis-0.2.0/metis/schemas/__init__.py +0 -0
  87. aimarket_metis-0.2.0/metis/schemas/task_spec.py +58 -0
  88. aimarket_metis-0.2.0/metis/security/__init__.py +32 -0
  89. aimarket_metis-0.2.0/metis/security/audit.py +33 -0
  90. aimarket_metis-0.2.0/metis/security/injection.py +130 -0
  91. aimarket_metis-0.2.0/metis/security/media.py +60 -0
  92. aimarket_metis-0.2.0/metis/security/ratelimit.py +78 -0
  93. aimarket_metis-0.2.0/metis/security/ssrf.py +121 -0
  94. aimarket_metis-0.2.0/metis/security.py +3 -0
  95. aimarket_metis-0.2.0/metis/serve.py +39 -0
  96. aimarket_metis-0.2.0/metis/thinking/__init__.py +0 -0
  97. aimarket_metis-0.2.0/metis/thinking/extended.py +82 -0
  98. aimarket_metis-0.2.0/metis/tools/__init__.py +0 -0
  99. aimarket_metis-0.2.0/metis/tools/aimarket.py +106 -0
  100. aimarket_metis-0.2.0/metis/tools/registry.py +185 -0
  101. aimarket_metis-0.2.0/metis/tools/sandbox.py +246 -0
  102. aimarket_metis-0.2.0/metis/training/__init__.py +0 -0
  103. aimarket_metis-0.2.0/metis/training/pipelines.py +68 -0
  104. aimarket_metis-0.2.0/metis/validation/__init__.py +61 -0
  105. aimarket_metis-0.2.0/metis/verify/__init__.py +0 -0
  106. aimarket_metis-0.2.0/metis/verify/critic.py +52 -0
  107. aimarket_metis-0.2.0/metis/verify/grounded.py +99 -0
  108. aimarket_metis-0.2.0/pyproject.toml +71 -0
  109. aimarket_metis-0.2.0/setup.cfg +4 -0
  110. aimarket_metis-0.2.0/tests/test_aimarket_invoke.py +109 -0
  111. aimarket_metis-0.2.0/tests/test_api.py +112 -0
  112. aimarket_metis-0.2.0/tests/test_api_app.py +65 -0
  113. aimarket_metis-0.2.0/tests/test_api_observability.py +62 -0
  114. aimarket_metis-0.2.0/tests/test_capability.py +132 -0
  115. aimarket_metis-0.2.0/tests/test_cli_commands.py +45 -0
  116. aimarket_metis-0.2.0/tests/test_coordinator_server.py +58 -0
  117. aimarket_metis-0.2.0/tests/test_core_coverage.py +64 -0
  118. aimarket_metis-0.2.0/tests/test_core_coverage_boost.py +87 -0
  119. aimarket_metis-0.2.0/tests/test_dgpd.py +101 -0
  120. aimarket_metis-0.2.0/tests/test_distributed.py +258 -0
  121. aimarket_metis-0.2.0/tests/test_docker_config.py +105 -0
  122. aimarket_metis-0.2.0/tests/test_economy.py +36 -0
  123. aimarket_metis-0.2.0/tests/test_ecosystem_api.py +164 -0
  124. aimarket_metis-0.2.0/tests/test_gates.py +57 -0
  125. aimarket_metis-0.2.0/tests/test_grounded_verify.py +81 -0
  126. aimarket_metis-0.2.0/tests/test_identity.py +81 -0
  127. aimarket_metis-0.2.0/tests/test_injection.py +103 -0
  128. aimarket_metis-0.2.0/tests/test_integration_e2e.py +115 -0
  129. aimarket_metis-0.2.0/tests/test_integration_v02.py +27 -0
  130. aimarket_metis-0.2.0/tests/test_knowledge.py +105 -0
  131. aimarket_metis-0.2.0/tests/test_mcp.py +73 -0
  132. aimarket_metis-0.2.0/tests/test_module_registry.py +102 -0
  133. aimarket_metis-0.2.0/tests/test_multimodal.py +195 -0
  134. aimarket_metis-0.2.0/tests/test_observability.py +175 -0
  135. aimarket_metis-0.2.0/tests/test_pipeline_agreement.py +40 -0
  136. aimarket_metis-0.2.0/tests/test_pipeline_event_sink.py +187 -0
  137. aimarket_metis-0.2.0/tests/test_reasoning_content.py +87 -0
  138. aimarket_metis-0.2.0/tests/test_runtime.py +96 -0
  139. aimarket_metis-0.2.0/tests/test_search_economy_env.py +70 -0
  140. aimarket_metis-0.2.0/tests/test_security.py +117 -0
@@ -0,0 +1,166 @@
1
+ Metadata-Version: 2.4
2
+ Name: aimarket-metis
3
+ Version: 0.2.0
4
+ Summary: Metis — distributed cognitive layer over any LLM
5
+ Author-email: alexar76 <publish@alexar76.dev>
6
+ License: MIT
7
+ Project-URL: Homepage, https://alexar76.github.io/metis/
8
+ Project-URL: Documentation, https://github.com/alexar76/metis
9
+ Project-URL: Repository, https://github.com/alexar76/metis
10
+ Project-URL: Issues, https://github.com/alexar76/metis/issues
11
+ Project-URL: Changelog, https://github.com/alexar76/metis/blob/main/CHANGELOG.md
12
+ Keywords: llm,multi-agent,reasoning,mcp,aimarket
13
+ Requires-Python: >=3.9
14
+ Description-Content-Type: text/markdown
15
+ Requires-Dist: pydantic>=2.0
16
+ Requires-Dist: pydantic-settings>=2.0
17
+ Requires-Dist: httpx>=0.27.0
18
+ Requires-Dist: pyyaml>=6.0
19
+ Provides-Extra: dev
20
+ Requires-Dist: hypothesis>=6.0; extra == "dev"
21
+ Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
22
+ Requires-Dist: pytest-cov>=5.0; extra == "dev"
23
+ Requires-Dist: pytest>=8.0; extra == "dev"
24
+ Provides-Extra: distributed
25
+ Requires-Dist: fastapi>=0.100; extra == "distributed"
26
+ Requires-Dist: uvicorn[standard]>=0.23; extra == "distributed"
27
+
28
+ # Metis
29
+
30
+ <!-- aicom-readme-badges -->
31
+ <p align="center">
32
+ <a href="https://github.com/alexar76/metis/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/alexar76/metis/ci.yml?branch=main&label=CI" alt="CI" /></a>
33
+ <img src="https://img.shields.io/badge/python-3.11%20%7C%203.12-blue" alt="Python 3.11 | 3.12" />
34
+ <img src="https://img.shields.io/badge/tests-237_passing-brightgreen" alt="237 tests passing" />
35
+ <a href="docs/badges/coverage.svg"><img src="docs/badges/coverage.svg" alt="Test coverage 82%" /></a>
36
+ <img src="https://img.shields.io/badge/license-MIT-blue" alt="License MIT" />
37
+ <img src="https://img.shields.io/badge/docker-ready-blue" alt="Docker ready" />
38
+ <a href="https://metis.modelmarket.dev/"><img src="https://img.shields.io/badge/demo-live-brightgreen" alt="Live demo" /></a>
39
+ </p>
40
+ <!-- /aicom-readme-badges -->
41
+ <!-- markers above: the GitHub mirror regenerates this block in place (no duplicate row). -->
42
+
43
+
44
+ <p align="center">
45
+ <strong>Metis</strong> (μῆτις) — distributed cognitive layer over any LLM<br/>
46
+ Part of the <a href="https://github.com/alexar76">alexar76</a> AI agent economy
47
+ </p>
48
+
49
+ <p align="center">
50
+ <a href="https://metis.modelmarket.dev/">
51
+ <img src="docs/screenshots/hero.png" alt="Metis live demo — interactive 3D superbrain with cognition graph and chat at metis.modelmarket.dev" width="820">
52
+ </a>
53
+ <br>
54
+ <sub>Grab the star · watch it pulse and think · chat with Metis — <a href="https://metis.modelmarket.dev/"><b>open the live demo →</b></a></sub>
55
+ </p>
56
+
57
+ 🌐 **Language:** **English** · [Русский](docs/ru/README.md) · [Español](docs/es/README.md)
58
+
59
+ **Multi-agent reasoning orchestrator** — Understanding Council, DGPD depth gating, layered MoA, verifier, memory, search, economy metering, distributed cluster, MCP tools, and OpenAI-compatible API.
60
+
61
+ ## Quick start
62
+
63
+ ```bash
64
+ python3 -m venv .venv && source .venv/bin/activate
65
+ pip install -e ".[dev,distributed]"
66
+ ollama pull qwen3:8b
67
+ metis "Explain multi-agent systems" --model qwen3:8b --url http://localhost:11434/v1
68
+ ```
69
+
70
+ ## Install
71
+
72
+ PyPI package name is **`aimarket-metis`** (the PyPI name `metis` is a different project). Import path and CLI stay **`metis`**, **`metis-serve`**, etc.
73
+
74
+ ```bash
75
+ # PyPI
76
+ pip install aimarket-metis
77
+ pip install "aimarket-metis[dev,distributed]"
78
+
79
+ # GitHub release tag
80
+ pip install "aimarket-metis[distributed] @ git+https://github.com/alexar76/metis.git@v0.2.0"
81
+
82
+ # Clone / monorepo (editable)
83
+ git clone https://github.com/alexar76/metis.git && cd metis
84
+ pip install -e ".[dev,distributed]"
85
+
86
+ # Docker
87
+ docker compose up -d
88
+ ```
89
+
90
+ ## Documentation index
91
+
92
+ | Resource | Link |
93
+ |----------|------|
94
+ | **Architecture** | [EN](docs/en/ARCHITECTURE.md) · [RU](docs/ru/ARCHITECTURE.md) · [ES](docs/es/ARCHITECTURE.md) |
95
+ | **API reference** | [EN](docs/en/API.md) · [RU](docs/ru/API.md) · [ES](docs/es/API.md) |
96
+ | **Deployment** | [EN](docs/en/DEPLOYMENT.md) · [RU](docs/ru/DEPLOYMENT.md) · [ES](docs/es/DEPLOYMENT.md) |
97
+ | **Security** | [EN](docs/en/SECURITY.md) · [RU](docs/ru/SECURITY.md) · [ES](docs/es/SECURITY.md) |
98
+ | **User guide** | [EN](docs/en/README.md) · [RU](docs/ru/README.md) · [ES](docs/es/README.md) |
99
+ | **Distributed** | [EN](docs/en/DISTRIBUTED.md) · [RU](docs/ru/DISTRIBUTED.md) · [ES](docs/es/DISTRIBUTED.md) |
100
+ | **Ecosystem** | [EN](docs/en/ECOSYSTEM.md) · [RU](docs/ru/ECOSYSTEM.md) · [ES](docs/es/ECOSYSTEM.md) |
101
+ | **Research** | [EN](docs/en/RESEARCH.md) · [RU](docs/ru/RESEARCH.md) · [ES](docs/es/RESEARCH.md) |
102
+ | **Wiki** | [Home](wiki/Home.md) · [Quick Start](wiki/Quick-Start.md) · [FAQ](wiki/FAQ.md) |
103
+ | **Landing page** | [Live demo](https://metis.modelmarket.dev/) · [docs/landing/index.html](docs/landing/index.html) · [deploy guide](docs/landing/README.md) |
104
+ | **Changelog** | [CHANGELOG.md](CHANGELOG.md) · [RELEASE.md](RELEASE.md) |
105
+
106
+ ## Ecosystem map
107
+
108
+ | Project | Role |
109
+ |---------|------|
110
+ | **[Metis](https://github.com/alexar76/metis)** | Cognitive orchestration layer (this repo) |
111
+ | **cognitive-runtime** | OpenAI API wrapper with DGPD |
112
+ | **[ARGUS-3](https://github.com/alexar76/argus)** | Demand-side reference agent + WARDEN MCP firewall |
113
+ | **[AIMarket Hub](https://github.com/alexar76/aimarket-hub)** | Federated capability catalog and invoke API |
114
+ | **[aimarket-oracle-gateway](https://github.com/alexar76/aimarket-oracle-gateway)** | Verifiable oracle MCP services |
115
+ | **[HELIOS](https://github.com/alexar76/helios)** | Broadcast pipeline for ecosystem content |
116
+ | **[AICOM](https://github.com/alexar76/aicom)** | AI-Factory — autonomous product pipeline |
117
+
118
+ ## CLI commands
119
+
120
+ | Command | Purpose |
121
+ |---------|---------|
122
+ | `metis` | Run a query through the cognitive stack |
123
+ | `metis-serve` | OpenAI-compatible API (`/v1/chat/completions`) |
124
+ | `metis-node` | Start a distributed worker node |
125
+ | `metis-coordinator` | Start the cluster coordinator |
126
+ | `metis-cluster` | Check cluster node health |
127
+
128
+ ## Architecture
129
+
130
+ ```mermaid
131
+ flowchart LR
132
+ Q["Query"] --> M["Metis"]
133
+ M --> R["Router"]
134
+ R --> C["Council/MoA/Agent"]
135
+ C --> P["LLM Providers"]
136
+ C --> T["Tools + MCP"]
137
+ M --> E["Economy Meter"]
138
+ ```
139
+
140
+ ## Production
141
+
142
+ ```bash
143
+ export METIS_API_KEY=sk-...
144
+ metis-serve --config config.production.yaml --production --port 8080
145
+ ```
146
+
147
+ Legacy env vars `SUPERBRAIN_*` and `COGNITIVE_*` are still read for one release cycle.
148
+
149
+ ## Docker
150
+
151
+ ```bash
152
+ cp config/docker.env.example .env
153
+ docker compose up -d --build
154
+ ```
155
+
156
+ ## Tests
157
+
158
+ ```bash
159
+ pytest --cov=metis --cov-report=term-missing -v
160
+ ```
161
+
162
+ ## Research citations
163
+
164
+ Design decisions are grounded in published work — see [docs/en/RESEARCH.md](docs/en/RESEARCH.md) for Yang et al. 2026 (heterogeneous agents), Wang et al. ICLR 2025 (layered MoA), and related citations with honest caveats.
165
+
166
+ MIT License
@@ -0,0 +1,139 @@
1
+ # Metis
2
+
3
+ <!-- aicom-readme-badges -->
4
+ <p align="center">
5
+ <a href="https://github.com/alexar76/metis/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/alexar76/metis/ci.yml?branch=main&label=CI" alt="CI" /></a>
6
+ <img src="https://img.shields.io/badge/python-3.11%20%7C%203.12-blue" alt="Python 3.11 | 3.12" />
7
+ <img src="https://img.shields.io/badge/tests-237_passing-brightgreen" alt="237 tests passing" />
8
+ <a href="docs/badges/coverage.svg"><img src="docs/badges/coverage.svg" alt="Test coverage 82%" /></a>
9
+ <img src="https://img.shields.io/badge/license-MIT-blue" alt="License MIT" />
10
+ <img src="https://img.shields.io/badge/docker-ready-blue" alt="Docker ready" />
11
+ <a href="https://metis.modelmarket.dev/"><img src="https://img.shields.io/badge/demo-live-brightgreen" alt="Live demo" /></a>
12
+ </p>
13
+ <!-- /aicom-readme-badges -->
14
+ <!-- markers above: the GitHub mirror regenerates this block in place (no duplicate row). -->
15
+
16
+
17
+ <p align="center">
18
+ <strong>Metis</strong> (μῆτις) — distributed cognitive layer over any LLM<br/>
19
+ Part of the <a href="https://github.com/alexar76">alexar76</a> AI agent economy
20
+ </p>
21
+
22
+ <p align="center">
23
+ <a href="https://metis.modelmarket.dev/">
24
+ <img src="docs/screenshots/hero.png" alt="Metis live demo — interactive 3D superbrain with cognition graph and chat at metis.modelmarket.dev" width="820">
25
+ </a>
26
+ <br>
27
+ <sub>Grab the star · watch it pulse and think · chat with Metis — <a href="https://metis.modelmarket.dev/"><b>open the live demo →</b></a></sub>
28
+ </p>
29
+
30
+ 🌐 **Language:** **English** · [Русский](docs/ru/README.md) · [Español](docs/es/README.md)
31
+
32
+ **Multi-agent reasoning orchestrator** — Understanding Council, DGPD depth gating, layered MoA, verifier, memory, search, economy metering, distributed cluster, MCP tools, and OpenAI-compatible API.
33
+
34
+ ## Quick start
35
+
36
+ ```bash
37
+ python3 -m venv .venv && source .venv/bin/activate
38
+ pip install -e ".[dev,distributed]"
39
+ ollama pull qwen3:8b
40
+ metis "Explain multi-agent systems" --model qwen3:8b --url http://localhost:11434/v1
41
+ ```
42
+
43
+ ## Install
44
+
45
+ PyPI package name is **`aimarket-metis`** (the PyPI name `metis` is a different project). Import path and CLI stay **`metis`**, **`metis-serve`**, etc.
46
+
47
+ ```bash
48
+ # PyPI
49
+ pip install aimarket-metis
50
+ pip install "aimarket-metis[dev,distributed]"
51
+
52
+ # GitHub release tag
53
+ pip install "aimarket-metis[distributed] @ git+https://github.com/alexar76/metis.git@v0.2.0"
54
+
55
+ # Clone / monorepo (editable)
56
+ git clone https://github.com/alexar76/metis.git && cd metis
57
+ pip install -e ".[dev,distributed]"
58
+
59
+ # Docker
60
+ docker compose up -d
61
+ ```
62
+
63
+ ## Documentation index
64
+
65
+ | Resource | Link |
66
+ |----------|------|
67
+ | **Architecture** | [EN](docs/en/ARCHITECTURE.md) · [RU](docs/ru/ARCHITECTURE.md) · [ES](docs/es/ARCHITECTURE.md) |
68
+ | **API reference** | [EN](docs/en/API.md) · [RU](docs/ru/API.md) · [ES](docs/es/API.md) |
69
+ | **Deployment** | [EN](docs/en/DEPLOYMENT.md) · [RU](docs/ru/DEPLOYMENT.md) · [ES](docs/es/DEPLOYMENT.md) |
70
+ | **Security** | [EN](docs/en/SECURITY.md) · [RU](docs/ru/SECURITY.md) · [ES](docs/es/SECURITY.md) |
71
+ | **User guide** | [EN](docs/en/README.md) · [RU](docs/ru/README.md) · [ES](docs/es/README.md) |
72
+ | **Distributed** | [EN](docs/en/DISTRIBUTED.md) · [RU](docs/ru/DISTRIBUTED.md) · [ES](docs/es/DISTRIBUTED.md) |
73
+ | **Ecosystem** | [EN](docs/en/ECOSYSTEM.md) · [RU](docs/ru/ECOSYSTEM.md) · [ES](docs/es/ECOSYSTEM.md) |
74
+ | **Research** | [EN](docs/en/RESEARCH.md) · [RU](docs/ru/RESEARCH.md) · [ES](docs/es/RESEARCH.md) |
75
+ | **Wiki** | [Home](wiki/Home.md) · [Quick Start](wiki/Quick-Start.md) · [FAQ](wiki/FAQ.md) |
76
+ | **Landing page** | [Live demo](https://metis.modelmarket.dev/) · [docs/landing/index.html](docs/landing/index.html) · [deploy guide](docs/landing/README.md) |
77
+ | **Changelog** | [CHANGELOG.md](CHANGELOG.md) · [RELEASE.md](RELEASE.md) |
78
+
79
+ ## Ecosystem map
80
+
81
+ | Project | Role |
82
+ |---------|------|
83
+ | **[Metis](https://github.com/alexar76/metis)** | Cognitive orchestration layer (this repo) |
84
+ | **cognitive-runtime** | OpenAI API wrapper with DGPD |
85
+ | **[ARGUS-3](https://github.com/alexar76/argus)** | Demand-side reference agent + WARDEN MCP firewall |
86
+ | **[AIMarket Hub](https://github.com/alexar76/aimarket-hub)** | Federated capability catalog and invoke API |
87
+ | **[aimarket-oracle-gateway](https://github.com/alexar76/aimarket-oracle-gateway)** | Verifiable oracle MCP services |
88
+ | **[HELIOS](https://github.com/alexar76/helios)** | Broadcast pipeline for ecosystem content |
89
+ | **[AICOM](https://github.com/alexar76/aicom)** | AI-Factory — autonomous product pipeline |
90
+
91
+ ## CLI commands
92
+
93
+ | Command | Purpose |
94
+ |---------|---------|
95
+ | `metis` | Run a query through the cognitive stack |
96
+ | `metis-serve` | OpenAI-compatible API (`/v1/chat/completions`) |
97
+ | `metis-node` | Start a distributed worker node |
98
+ | `metis-coordinator` | Start the cluster coordinator |
99
+ | `metis-cluster` | Check cluster node health |
100
+
101
+ ## Architecture
102
+
103
+ ```mermaid
104
+ flowchart LR
105
+ Q["Query"] --> M["Metis"]
106
+ M --> R["Router"]
107
+ R --> C["Council/MoA/Agent"]
108
+ C --> P["LLM Providers"]
109
+ C --> T["Tools + MCP"]
110
+ M --> E["Economy Meter"]
111
+ ```
112
+
113
+ ## Production
114
+
115
+ ```bash
116
+ export METIS_API_KEY=sk-...
117
+ metis-serve --config config.production.yaml --production --port 8080
118
+ ```
119
+
120
+ Legacy env vars `SUPERBRAIN_*` and `COGNITIVE_*` are still read for one release cycle.
121
+
122
+ ## Docker
123
+
124
+ ```bash
125
+ cp config/docker.env.example .env
126
+ docker compose up -d --build
127
+ ```
128
+
129
+ ## Tests
130
+
131
+ ```bash
132
+ pytest --cov=metis --cov-report=term-missing -v
133
+ ```
134
+
135
+ ## Research citations
136
+
137
+ Design decisions are grounded in published work — see [docs/en/RESEARCH.md](docs/en/RESEARCH.md) for Yang et al. 2026 (heterogeneous agents), Wang et al. ICLR 2025 (layered MoA), and related citations with honest caveats.
138
+
139
+ MIT License
@@ -0,0 +1,166 @@
1
+ Metadata-Version: 2.4
2
+ Name: aimarket-metis
3
+ Version: 0.2.0
4
+ Summary: Metis — distributed cognitive layer over any LLM
5
+ Author-email: alexar76 <publish@alexar76.dev>
6
+ License: MIT
7
+ Project-URL: Homepage, https://alexar76.github.io/metis/
8
+ Project-URL: Documentation, https://github.com/alexar76/metis
9
+ Project-URL: Repository, https://github.com/alexar76/metis
10
+ Project-URL: Issues, https://github.com/alexar76/metis/issues
11
+ Project-URL: Changelog, https://github.com/alexar76/metis/blob/main/CHANGELOG.md
12
+ Keywords: llm,multi-agent,reasoning,mcp,aimarket
13
+ Requires-Python: >=3.9
14
+ Description-Content-Type: text/markdown
15
+ Requires-Dist: pydantic>=2.0
16
+ Requires-Dist: pydantic-settings>=2.0
17
+ Requires-Dist: httpx>=0.27.0
18
+ Requires-Dist: pyyaml>=6.0
19
+ Provides-Extra: dev
20
+ Requires-Dist: hypothesis>=6.0; extra == "dev"
21
+ Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
22
+ Requires-Dist: pytest-cov>=5.0; extra == "dev"
23
+ Requires-Dist: pytest>=8.0; extra == "dev"
24
+ Provides-Extra: distributed
25
+ Requires-Dist: fastapi>=0.100; extra == "distributed"
26
+ Requires-Dist: uvicorn[standard]>=0.23; extra == "distributed"
27
+
28
+ # Metis
29
+
30
+ <!-- aicom-readme-badges -->
31
+ <p align="center">
32
+ <a href="https://github.com/alexar76/metis/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/alexar76/metis/ci.yml?branch=main&label=CI" alt="CI" /></a>
33
+ <img src="https://img.shields.io/badge/python-3.11%20%7C%203.12-blue" alt="Python 3.11 | 3.12" />
34
+ <img src="https://img.shields.io/badge/tests-237_passing-brightgreen" alt="237 tests passing" />
35
+ <a href="docs/badges/coverage.svg"><img src="docs/badges/coverage.svg" alt="Test coverage 82%" /></a>
36
+ <img src="https://img.shields.io/badge/license-MIT-blue" alt="License MIT" />
37
+ <img src="https://img.shields.io/badge/docker-ready-blue" alt="Docker ready" />
38
+ <a href="https://metis.modelmarket.dev/"><img src="https://img.shields.io/badge/demo-live-brightgreen" alt="Live demo" /></a>
39
+ </p>
40
+ <!-- /aicom-readme-badges -->
41
+ <!-- markers above: the GitHub mirror regenerates this block in place (no duplicate row). -->
42
+
43
+
44
+ <p align="center">
45
+ <strong>Metis</strong> (μῆτις) — distributed cognitive layer over any LLM<br/>
46
+ Part of the <a href="https://github.com/alexar76">alexar76</a> AI agent economy
47
+ </p>
48
+
49
+ <p align="center">
50
+ <a href="https://metis.modelmarket.dev/">
51
+ <img src="docs/screenshots/hero.png" alt="Metis live demo — interactive 3D superbrain with cognition graph and chat at metis.modelmarket.dev" width="820">
52
+ </a>
53
+ <br>
54
+ <sub>Grab the star · watch it pulse and think · chat with Metis — <a href="https://metis.modelmarket.dev/"><b>open the live demo →</b></a></sub>
55
+ </p>
56
+
57
+ 🌐 **Language:** **English** · [Русский](docs/ru/README.md) · [Español](docs/es/README.md)
58
+
59
+ **Multi-agent reasoning orchestrator** — Understanding Council, DGPD depth gating, layered MoA, verifier, memory, search, economy metering, distributed cluster, MCP tools, and OpenAI-compatible API.
60
+
61
+ ## Quick start
62
+
63
+ ```bash
64
+ python3 -m venv .venv && source .venv/bin/activate
65
+ pip install -e ".[dev,distributed]"
66
+ ollama pull qwen3:8b
67
+ metis "Explain multi-agent systems" --model qwen3:8b --url http://localhost:11434/v1
68
+ ```
69
+
70
+ ## Install
71
+
72
+ PyPI package name is **`aimarket-metis`** (the PyPI name `metis` is a different project). Import path and CLI stay **`metis`**, **`metis-serve`**, etc.
73
+
74
+ ```bash
75
+ # PyPI
76
+ pip install aimarket-metis
77
+ pip install "aimarket-metis[dev,distributed]"
78
+
79
+ # GitHub release tag
80
+ pip install "aimarket-metis[distributed] @ git+https://github.com/alexar76/metis.git@v0.2.0"
81
+
82
+ # Clone / monorepo (editable)
83
+ git clone https://github.com/alexar76/metis.git && cd metis
84
+ pip install -e ".[dev,distributed]"
85
+
86
+ # Docker
87
+ docker compose up -d
88
+ ```
89
+
90
+ ## Documentation index
91
+
92
+ | Resource | Link |
93
+ |----------|------|
94
+ | **Architecture** | [EN](docs/en/ARCHITECTURE.md) · [RU](docs/ru/ARCHITECTURE.md) · [ES](docs/es/ARCHITECTURE.md) |
95
+ | **API reference** | [EN](docs/en/API.md) · [RU](docs/ru/API.md) · [ES](docs/es/API.md) |
96
+ | **Deployment** | [EN](docs/en/DEPLOYMENT.md) · [RU](docs/ru/DEPLOYMENT.md) · [ES](docs/es/DEPLOYMENT.md) |
97
+ | **Security** | [EN](docs/en/SECURITY.md) · [RU](docs/ru/SECURITY.md) · [ES](docs/es/SECURITY.md) |
98
+ | **User guide** | [EN](docs/en/README.md) · [RU](docs/ru/README.md) · [ES](docs/es/README.md) |
99
+ | **Distributed** | [EN](docs/en/DISTRIBUTED.md) · [RU](docs/ru/DISTRIBUTED.md) · [ES](docs/es/DISTRIBUTED.md) |
100
+ | **Ecosystem** | [EN](docs/en/ECOSYSTEM.md) · [RU](docs/ru/ECOSYSTEM.md) · [ES](docs/es/ECOSYSTEM.md) |
101
+ | **Research** | [EN](docs/en/RESEARCH.md) · [RU](docs/ru/RESEARCH.md) · [ES](docs/es/RESEARCH.md) |
102
+ | **Wiki** | [Home](wiki/Home.md) · [Quick Start](wiki/Quick-Start.md) · [FAQ](wiki/FAQ.md) |
103
+ | **Landing page** | [Live demo](https://metis.modelmarket.dev/) · [docs/landing/index.html](docs/landing/index.html) · [deploy guide](docs/landing/README.md) |
104
+ | **Changelog** | [CHANGELOG.md](CHANGELOG.md) · [RELEASE.md](RELEASE.md) |
105
+
106
+ ## Ecosystem map
107
+
108
+ | Project | Role |
109
+ |---------|------|
110
+ | **[Metis](https://github.com/alexar76/metis)** | Cognitive orchestration layer (this repo) |
111
+ | **cognitive-runtime** | OpenAI API wrapper with DGPD |
112
+ | **[ARGUS-3](https://github.com/alexar76/argus)** | Demand-side reference agent + WARDEN MCP firewall |
113
+ | **[AIMarket Hub](https://github.com/alexar76/aimarket-hub)** | Federated capability catalog and invoke API |
114
+ | **[aimarket-oracle-gateway](https://github.com/alexar76/aimarket-oracle-gateway)** | Verifiable oracle MCP services |
115
+ | **[HELIOS](https://github.com/alexar76/helios)** | Broadcast pipeline for ecosystem content |
116
+ | **[AICOM](https://github.com/alexar76/aicom)** | AI-Factory — autonomous product pipeline |
117
+
118
+ ## CLI commands
119
+
120
+ | Command | Purpose |
121
+ |---------|---------|
122
+ | `metis` | Run a query through the cognitive stack |
123
+ | `metis-serve` | OpenAI-compatible API (`/v1/chat/completions`) |
124
+ | `metis-node` | Start a distributed worker node |
125
+ | `metis-coordinator` | Start the cluster coordinator |
126
+ | `metis-cluster` | Check cluster node health |
127
+
128
+ ## Architecture
129
+
130
+ ```mermaid
131
+ flowchart LR
132
+ Q["Query"] --> M["Metis"]
133
+ M --> R["Router"]
134
+ R --> C["Council/MoA/Agent"]
135
+ C --> P["LLM Providers"]
136
+ C --> T["Tools + MCP"]
137
+ M --> E["Economy Meter"]
138
+ ```
139
+
140
+ ## Production
141
+
142
+ ```bash
143
+ export METIS_API_KEY=sk-...
144
+ metis-serve --config config.production.yaml --production --port 8080
145
+ ```
146
+
147
+ Legacy env vars `SUPERBRAIN_*` and `COGNITIVE_*` are still read for one release cycle.
148
+
149
+ ## Docker
150
+
151
+ ```bash
152
+ cp config/docker.env.example .env
153
+ docker compose up -d --build
154
+ ```
155
+
156
+ ## Tests
157
+
158
+ ```bash
159
+ pytest --cov=metis --cov-report=term-missing -v
160
+ ```
161
+
162
+ ## Research citations
163
+
164
+ Design decisions are grounded in published work — see [docs/en/RESEARCH.md](docs/en/RESEARCH.md) for Yang et al. 2026 (heterogeneous agents), Wang et al. ICLR 2025 (layered MoA), and related citations with honest caveats.
165
+
166
+ MIT License
@@ -0,0 +1,138 @@
1
+ README.md
2
+ pyproject.toml
3
+ aimarket_metis.egg-info/PKG-INFO
4
+ aimarket_metis.egg-info/SOURCES.txt
5
+ aimarket_metis.egg-info/dependency_links.txt
6
+ aimarket_metis.egg-info/entry_points.txt
7
+ aimarket_metis.egg-info/requires.txt
8
+ aimarket_metis.egg-info/top_level.txt
9
+ metis/__init__.py
10
+ metis/cli.py
11
+ metis/config.py
12
+ metis/coordinator_server.py
13
+ metis/env_compat.py
14
+ metis/exoskeleton.py
15
+ metis/security.py
16
+ metis/serve.py
17
+ metis/agents/__init__.py
18
+ metis/agents/capability.py
19
+ metis/agents/council.py
20
+ metis/agents/diversity.py
21
+ metis/agents/loop.py
22
+ metis/agents/moa.py
23
+ metis/api/__init__.py
24
+ metis/api/app.py
25
+ metis/api/auth.py
26
+ metis/api/bridge.py
27
+ metis/api/ecosystem.py
28
+ metis/api/observability_routes.py
29
+ metis/api/openai_compat.py
30
+ metis/api/rate_limit.py
31
+ metis/api/schemas.py
32
+ metis/distributed/__init__.py
33
+ metis/distributed/cli.py
34
+ metis/distributed/coordinator.py
35
+ metis/distributed/node.py
36
+ metis/distributed/protocol.py
37
+ metis/distributed/registry.py
38
+ metis/distributed/remote_provider.py
39
+ metis/distributed/security.py
40
+ metis/distributed/server.py
41
+ metis/economy/__init__.py
42
+ metis/economy/bridge.py
43
+ metis/economy/config.py
44
+ metis/economy/cost.py
45
+ metis/economy/meter.py
46
+ metis/economy/tracked.py
47
+ metis/gates/__init__.py
48
+ metis/knowledge/__init__.py
49
+ metis/knowledge/cli.py
50
+ metis/knowledge/config.py
51
+ metis/knowledge/experience.py
52
+ metis/knowledge/failures.py
53
+ metis/knowledge/store.py
54
+ metis/mcp/__init__.py
55
+ metis/mcp/client.py
56
+ metis/mcp/config.py
57
+ metis/mcp/discovery.py
58
+ metis/mcp/registry.py
59
+ metis/mcp/sse.py
60
+ metis/memory/__init__.py
61
+ metis/memory/store.py
62
+ metis/models/__init__.py
63
+ metis/models/anthropic.py
64
+ metis/models/provider.py
65
+ metis/modules/__init__.py
66
+ metis/modules/registry.py
67
+ metis/observability/__init__.py
68
+ metis/observability/cli.py
69
+ metis/observability/config.py
70
+ metis/observability/trace_store.py
71
+ metis/observability/logging/__init__.py
72
+ metis/observability/logging/audit.py
73
+ metis/observability/logging/module_logger.py
74
+ metis/observability/logging/pipeline_events.py
75
+ metis/observability/logging/tracer.py
76
+ metis/observability/reliability/__init__.py
77
+ metis/observability/reliability/circuit_breaker.py
78
+ metis/observability/reliability/detector.py
79
+ metis/observability/reliability/retry.py
80
+ metis/pipeline/__init__.py
81
+ metis/pipeline/agreement.py
82
+ metis/pipeline/depth.py
83
+ metis/pipeline/escalation.py
84
+ metis/rag/__init__.py
85
+ metis/rag/agentic.py
86
+ metis/router/__init__.py
87
+ metis/router/classifier.py
88
+ metis/schemas/__init__.py
89
+ metis/schemas/task_spec.py
90
+ metis/security/__init__.py
91
+ metis/security/audit.py
92
+ metis/security/injection.py
93
+ metis/security/media.py
94
+ metis/security/ratelimit.py
95
+ metis/security/ssrf.py
96
+ metis/thinking/__init__.py
97
+ metis/thinking/extended.py
98
+ metis/tools/__init__.py
99
+ metis/tools/aimarket.py
100
+ metis/tools/registry.py
101
+ metis/tools/sandbox.py
102
+ metis/training/__init__.py
103
+ metis/training/pipelines.py
104
+ metis/validation/__init__.py
105
+ metis/verify/__init__.py
106
+ metis/verify/critic.py
107
+ metis/verify/grounded.py
108
+ tests/test_aimarket_invoke.py
109
+ tests/test_api.py
110
+ tests/test_api_app.py
111
+ tests/test_api_observability.py
112
+ tests/test_capability.py
113
+ tests/test_cli_commands.py
114
+ tests/test_coordinator_server.py
115
+ tests/test_core_coverage.py
116
+ tests/test_core_coverage_boost.py
117
+ tests/test_dgpd.py
118
+ tests/test_distributed.py
119
+ tests/test_docker_config.py
120
+ tests/test_economy.py
121
+ tests/test_ecosystem_api.py
122
+ tests/test_gates.py
123
+ tests/test_grounded_verify.py
124
+ tests/test_identity.py
125
+ tests/test_injection.py
126
+ tests/test_integration_e2e.py
127
+ tests/test_integration_v02.py
128
+ tests/test_knowledge.py
129
+ tests/test_mcp.py
130
+ tests/test_module_registry.py
131
+ tests/test_multimodal.py
132
+ tests/test_observability.py
133
+ tests/test_pipeline_agreement.py
134
+ tests/test_pipeline_event_sink.py
135
+ tests/test_reasoning_content.py
136
+ tests/test_runtime.py
137
+ tests/test_search_economy_env.py
138
+ tests/test_security.py
@@ -0,0 +1,7 @@
1
+ [console_scripts]
2
+ metis = metis.cli:main
3
+ metis-benchmark = benchmarks.run:main
4
+ metis-cluster = metis.distributed.cli:cluster_status_main
5
+ metis-coordinator = metis.distributed.cli:coordinator_serve_main
6
+ metis-node = metis.distributed.cli:node_serve_main
7
+ metis-serve = metis.serve:serve_main
@@ -0,0 +1,14 @@
1
+ pydantic>=2.0
2
+ pydantic-settings>=2.0
3
+ httpx>=0.27.0
4
+ pyyaml>=6.0
5
+
6
+ [dev]
7
+ hypothesis>=6.0
8
+ pytest-asyncio>=0.23
9
+ pytest-cov>=5.0
10
+ pytest>=8.0
11
+
12
+ [distributed]
13
+ fastapi>=0.100
14
+ uvicorn[standard]>=0.23
@@ -0,0 +1,7 @@
1
+ """Metis — multi-agent reasoning orchestrator for any LLM."""
2
+
3
+ from metis.exoskeleton import Metis, ExoskeletonResult, CognitiveExoskeleton, Superbrain
4
+ from metis.config import RuntimeConfig
5
+
6
+ __all__ = ["Metis", "Superbrain", "CognitiveExoskeleton", "ExoskeletonResult", "RuntimeConfig"]
7
+ __version__ = "0.1.0"
File without changes