matimo 0.1.0__tar.gz

matimo-0.1.0/.gitignore

@@ -0,0 +1,63 @@
+# Dependencies
+**/node_modules/
+package-lock.json
+yarn.lock
+
+# Build output
+**/dist/
+*.tsbuildinfo
+
+# Python compiled / build
+**/__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+**/build/
+**/.eggs/
+**/.venv/
+**/.mypy_cache/
+**/.ruff_cache/
+**/.pytest_cache/
+
+# Test coverage
+**/coverage/
+**/.nyc_output/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+typescript/examples/mcp/matimo-tools/.matimo-approvals.json
+typescript/examples/mcp/matimo-tools/fetch-weather/definition.yaml
+typescript/examples/mcp/matimo-tools/npm_downloads/definition.yaml
+typescript/examples/mcp/matimo-tools/skills/ecosystem-health/SKILL.md
+typescript/examples/mcp/matimo-tools/skills/matimo-health-check/SKILL.md
+typescript/examples/mcp/matimo-tools/skills/moltbook-identity/SKILL.md
+typescript/packages/cli/.matimo/certs/server.crt
+typescript/packages/cli/.matimo/certs/server.key
+typescript/examples/mcp/.matimo/certs/server.crt
+typescript/examples/mcp/.matimo/certs/server.key

matimo-0.1.0/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: matimo
+Version: 0.1.0
+Summary: Matimo — framework-agnostic SDK: pre-built providers, skills layer, MCP out of the box, and autonomous agents governed by a policy engine you control
+Project-URL: Homepage, https://matimo.dev
+Project-URL: Documentation, https://matimo.dev/docs
+Project-URL: Repository, https://github.com/tallclub/matimo
+Project-URL: Issues, https://github.com/tallclub/matimo/issues
+License: MIT
+Keywords: agents,ai,crewai,langchain,matimo,mcp,tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Requires-Dist: matimo-cli<0.2.0,>=0.1.0a14.post1
+Requires-Dist: matimo-core<0.2.0,>=0.1.0
+Provides-Extra: all
+Requires-Dist: matimo-core[all]; extra == 'all'
+Provides-Extra: aws
+Requires-Dist: matimo-core[aws]; extra == 'aws'
+Provides-Extra: crewai
+Requires-Dist: matimo-core[crewai]; extra == 'crewai'
+Provides-Extra: dotenv
+Requires-Dist: matimo-core[dotenv]; extra == 'dotenv'
+Provides-Extra: langchain
+Requires-Dist: matimo-core[langchain]; extra == 'langchain'
+Provides-Extra: mcp
+Requires-Dist: matimo-core[mcp]; extra == 'mcp'
+Provides-Extra: vault
+Requires-Dist: matimo-core[vault]; extra == 'vault'
+Description-Content-Type: text/markdown
+
+# matimo
+
+> A framework-agnostic SDK with pre-built providers, a skills knowledge layer, MCP out of the box, and agents that autonomously build new capabilities — governed by a policy engine you control.
+
+[![PyPI](https://img.shields.io/pypi/v/matimo)](https://pypi.org/project/matimo/)
+[![Python](https://img.shields.io/pypi/pyversions/matimo)](https://pypi.org/project/matimo/)
+[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+
+`matimo` is the convenience meta-package that installs [`matimo-core`](https://pypi.org/project/matimo-core/) and [`matimo-cli`](https://pypi.org/project/matimo-cli/). Provider packages (Slack, GitHub, Gmail, etc.) are installed separately.
+
+---
+
+## Installation
+
+```bash
+# Core SDK + CLI
+pip install matimo
+
+# With optional framework integrations
+pip install "matimo[langchain]"   # LangChain support
+pip install "matimo[crewai]"      # CrewAI support
+pip install "matimo[mcp]"         # MCP server support
+
+# With secrets backends
+pip install "matimo[dotenv]"      # .env file support
+pip install "matimo[vault]"       # HashiCorp Vault
+pip install "matimo[aws]"         # AWS Secrets Manager
+
+# Everything (all optional integrations)
+pip install "matimo[all]"
+
+# With provider packages
+pip install matimo matimo-slack matimo-github matimo-gmail
+```
+
+---
+
+## Quick Start
+
+### Factory pattern
+
+```python
+import asyncio
+from matimo import Matimo
+
+async def main():
+    matimo = await Matimo.init('./tools')
+    result = await matimo.execute('my_tool', {'param': 'value'})
+    print(result)
+
+asyncio.run(main())
+```
+
+### Auto-discover installed providers
+
+```python
+from matimo import Matimo
+
+matimo = await Matimo.init(auto_discover=True)
+print([t.name for t in matimo.list_tools()])
+```
+
+### With provider packages
+
+```python
+from matimo import Matimo
+from matimo_slack import get_tools_path as slack_tools
+from matimo_github import get_tools_path as github_tools
+
+matimo = await Matimo.init([slack_tools(), github_tools()])
+result = await matimo.execute('slack_send_channel_message', {
+    'channel': '#general',
+    'text': 'Hello from Matimo!',
+})
+```
+
+### LangChain agent
+
+```python
+from matimo import Matimo
+from matimo.integrations.langchain import convert_tools_to_langchain
+from langchain_openai import ChatOpenAI
+from langchain.agents import AgentExecutor, create_tool_calling_agent
+from langchain_core.prompts import ChatPromptTemplate
+
+matimo = await Matimo.init(auto_discover=True)
+lc_tools = convert_tools_to_langchain(matimo.list_tools(), matimo)
+
+llm = ChatOpenAI(model='gpt-4o-mini')
+prompt = ChatPromptTemplate.from_messages([
+    ('system', 'You are a helpful assistant.'),
+    ('human', '{input}'),
+    ('placeholder', '{agent_scratchpad}'),
+])
+agent = create_tool_calling_agent(llm, lc_tools, prompt)
+executor = AgentExecutor(agent=agent, tools=lc_tools)
+result = await executor.ainvoke({'input': 'List all Slack channels'})
+```
+
+### CrewAI agent
+
+```python
+from matimo import Matimo
+from matimo.integrations.crewai import convert_tools_to_crewai
+
+matimo = await Matimo.init(auto_discover=True)
+crewai_tools = convert_tools_to_crewai(matimo.list_tools(), matimo)
+```
+
+### MCP server (Claude Desktop / Cursor)
+
+```python
+from matimo import Matimo, create_mcp_server, MCPServerOptions
+
+matimo = await Matimo.init(auto_discover=True)
+server = await create_mcp_server(matimo, MCPServerOptions(name='my-agent', version='1.0.0'))
+await server.start()
+```
+
+---
+
+## Provider Packages
+
+Install the tools you need:
+
+| Package | Tools | Install |
+|---------|-------|---------|
+| [`matimo-slack`](https://pypi.org/project/matimo-slack/) | Messaging, channels, files, reactions | `pip install matimo-slack` |
+| [`matimo-github`](https://pypi.org/project/matimo-github/) | Repos, issues, PRs, releases | `pip install matimo-github` |
+| [`matimo-gmail`](https://pypi.org/project/matimo-gmail/) | Send, list, read, delete emails | `pip install matimo-gmail` |
+| [`matimo-notion`](https://pypi.org/project/matimo-notion/) | Pages, databases, comments | `pip install matimo-notion` |
+| [`matimo-postgres`](https://pypi.org/project/matimo-postgres/) | Execute SQL queries | `pip install matimo-postgres` |
+| [`matimo-twilio`](https://pypi.org/project/matimo-twilio/) | SMS, MMS, message history | `pip install matimo-twilio` |
+| [`matimo-hubspot`](https://pypi.org/project/matimo-hubspot/) | CRM: contacts, deals, companies | `pip install matimo-hubspot` |
+| [`matimo-mailchimp`](https://pypi.org/project/matimo-mailchimp/) | Campaigns, lists, members | `pip install matimo-mailchimp` |
+
+---
+
+## Key Features
+
+- **YAML-defined tools** — define once, use from any framework
+- **10 provider packages** — 100+ pre-built tools ready to use
+- **LangChain / CrewAI / MCP** — first-class integrations
+- **Policy engine** — risk classification, HITL approvals, content validation
+- **Skills system** — inject reusable domain knowledge into agents
+- **Meta-tools** — agents can create, approve, and reload tools at runtime
+- **Secrets management** — env, `.env`, Vault, AWS Secrets Manager resolver chain
+- **Structured logging** — JSON/simple formats, configurable log levels
+
+---
+
+## Documentation
+
+- [Getting Started](https://matimo.dev/docs/getting-started/QUICK_START)
+- [API Reference](https://matimo.dev/docs/api-reference/SDK)
+- [LangChain Integration](https://matimo.dev/docs/framework-integrations/LANGCHAIN)
+- [CrewAI Integration](https://matimo.dev/docs/framework-integrations/CREWAI)
+- [MCP Guide](https://matimo.dev/docs/MCP)
+- [Policy & Lifecycle](https://matimo.dev/docs/api-reference/POLICY_AND_LIFECYCLE)
+
+---
+
+## Links
+
+- **PyPI:** https://pypi.org/project/matimo/
+- **Docs:** https://matimo.dev/docs
+- **GitHub:** https://github.com/tallclub/matimo
+- **Changelog:** https://github.com/tallclub/matimo/blob/main/docs/RELEASES.md
+

matimo-0.1.0/README.md

@@ -0,0 +1,169 @@
+# matimo
+
+> A framework-agnostic SDK with pre-built providers, a skills knowledge layer, MCP out of the box, and agents that autonomously build new capabilities — governed by a policy engine you control.
+
+[![PyPI](https://img.shields.io/pypi/v/matimo)](https://pypi.org/project/matimo/)
+[![Python](https://img.shields.io/pypi/pyversions/matimo)](https://pypi.org/project/matimo/)
+[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+
+`matimo` is the convenience meta-package that installs [`matimo-core`](https://pypi.org/project/matimo-core/) and [`matimo-cli`](https://pypi.org/project/matimo-cli/). Provider packages (Slack, GitHub, Gmail, etc.) are installed separately.
+
+---
+
+## Installation
+
+```bash
+# Core SDK + CLI
+pip install matimo
+
+# With optional framework integrations
+pip install "matimo[langchain]"   # LangChain support
+pip install "matimo[crewai]"      # CrewAI support
+pip install "matimo[mcp]"         # MCP server support
+
+# With secrets backends
+pip install "matimo[dotenv]"      # .env file support
+pip install "matimo[vault]"       # HashiCorp Vault
+pip install "matimo[aws]"         # AWS Secrets Manager
+
+# Everything (all optional integrations)
+pip install "matimo[all]"
+
+# With provider packages
+pip install matimo matimo-slack matimo-github matimo-gmail
+```
+
+---
+
+## Quick Start
+
+### Factory pattern
+
+```python
+import asyncio
+from matimo import Matimo
+
+async def main():
+    matimo = await Matimo.init('./tools')
+    result = await matimo.execute('my_tool', {'param': 'value'})
+    print(result)
+
+asyncio.run(main())
+```
+
+### Auto-discover installed providers
+
+```python
+from matimo import Matimo
+
+matimo = await Matimo.init(auto_discover=True)
+print([t.name for t in matimo.list_tools()])
+```
+
+### With provider packages
+
+```python
+from matimo import Matimo
+from matimo_slack import get_tools_path as slack_tools
+from matimo_github import get_tools_path as github_tools
+
+matimo = await Matimo.init([slack_tools(), github_tools()])
+result = await matimo.execute('slack_send_channel_message', {
+    'channel': '#general',
+    'text': 'Hello from Matimo!',
+})
+```
+
+### LangChain agent
+
+```python
+from matimo import Matimo
+from matimo.integrations.langchain import convert_tools_to_langchain
+from langchain_openai import ChatOpenAI
+from langchain.agents import AgentExecutor, create_tool_calling_agent
+from langchain_core.prompts import ChatPromptTemplate
+
+matimo = await Matimo.init(auto_discover=True)
+lc_tools = convert_tools_to_langchain(matimo.list_tools(), matimo)
+
+llm = ChatOpenAI(model='gpt-4o-mini')
+prompt = ChatPromptTemplate.from_messages([
+    ('system', 'You are a helpful assistant.'),
+    ('human', '{input}'),
+    ('placeholder', '{agent_scratchpad}'),
+])
+agent = create_tool_calling_agent(llm, lc_tools, prompt)
+executor = AgentExecutor(agent=agent, tools=lc_tools)
+result = await executor.ainvoke({'input': 'List all Slack channels'})
+```
+
+### CrewAI agent
+
+```python
+from matimo import Matimo
+from matimo.integrations.crewai import convert_tools_to_crewai
+
+matimo = await Matimo.init(auto_discover=True)
+crewai_tools = convert_tools_to_crewai(matimo.list_tools(), matimo)
+```
+
+### MCP server (Claude Desktop / Cursor)
+
+```python
+from matimo import Matimo, create_mcp_server, MCPServerOptions
+
+matimo = await Matimo.init(auto_discover=True)
+server = await create_mcp_server(matimo, MCPServerOptions(name='my-agent', version='1.0.0'))
+await server.start()
+```
+
+---
+
+## Provider Packages
+
+Install the tools you need:
+
+| Package | Tools | Install |
+|---------|-------|---------|
+| [`matimo-slack`](https://pypi.org/project/matimo-slack/) | Messaging, channels, files, reactions | `pip install matimo-slack` |
+| [`matimo-github`](https://pypi.org/project/matimo-github/) | Repos, issues, PRs, releases | `pip install matimo-github` |
+| [`matimo-gmail`](https://pypi.org/project/matimo-gmail/) | Send, list, read, delete emails | `pip install matimo-gmail` |
+| [`matimo-notion`](https://pypi.org/project/matimo-notion/) | Pages, databases, comments | `pip install matimo-notion` |
+| [`matimo-postgres`](https://pypi.org/project/matimo-postgres/) | Execute SQL queries | `pip install matimo-postgres` |
+| [`matimo-twilio`](https://pypi.org/project/matimo-twilio/) | SMS, MMS, message history | `pip install matimo-twilio` |
+| [`matimo-hubspot`](https://pypi.org/project/matimo-hubspot/) | CRM: contacts, deals, companies | `pip install matimo-hubspot` |
+| [`matimo-mailchimp`](https://pypi.org/project/matimo-mailchimp/) | Campaigns, lists, members | `pip install matimo-mailchimp` |
+
+---
+
+## Key Features
+
+- **YAML-defined tools** — define once, use from any framework
+- **10 provider packages** — 100+ pre-built tools ready to use
+- **LangChain / CrewAI / MCP** — first-class integrations
+- **Policy engine** — risk classification, HITL approvals, content validation
+- **Skills system** — inject reusable domain knowledge into agents
+- **Meta-tools** — agents can create, approve, and reload tools at runtime
+- **Secrets management** — env, `.env`, Vault, AWS Secrets Manager resolver chain
+- **Structured logging** — JSON/simple formats, configurable log levels
+
+---
+
+## Documentation
+
+- [Getting Started](https://matimo.dev/docs/getting-started/QUICK_START)
+- [API Reference](https://matimo.dev/docs/api-reference/SDK)
+- [LangChain Integration](https://matimo.dev/docs/framework-integrations/LANGCHAIN)
+- [CrewAI Integration](https://matimo.dev/docs/framework-integrations/CREWAI)
+- [MCP Guide](https://matimo.dev/docs/MCP)
+- [Policy & Lifecycle](https://matimo.dev/docs/api-reference/POLICY_AND_LIFECYCLE)
+
+---
+
+## Links
+
+- **PyPI:** https://pypi.org/project/matimo/
+- **Docs:** https://matimo.dev/docs
+- **GitHub:** https://github.com/tallclub/matimo
+- **Changelog:** https://github.com/tallclub/matimo/blob/main/docs/RELEASES.md
+

matimo-0.1.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "matimo"
+version = "0.1.0"
+description = "Matimo — framework-agnostic SDK: pre-built providers, skills layer, MCP out of the box, and autonomous agents governed by a policy engine you control"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+keywords = ["ai", "tools", "agents", "langchain", "crewai", "mcp", "matimo"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+# This is a meta-package: pip install matimo pulls in matimo-core and matimo-cli
+# which provides the actual `matimo` Python namespace and CLI tools.
+dependencies = [
+    "matimo-core>=0.1.0,<0.2.0",
+    "matimo-cli>=0.1.0a14.post1,<0.2.0",
+]
+
+[project.optional-dependencies]
+langchain = ["matimo-core[langchain]"]
+crewai = ["matimo-core[crewai]"]
+mcp = ["matimo-core[mcp]"]
+dotenv = ["matimo-core[dotenv]"]
+vault = ["matimo-core[vault]"]
+aws = ["matimo-core[aws]"]
+all = ["matimo-core[all]"]
+
+[project.urls]
+Homepage = "https://matimo.dev"
+Documentation = "https://matimo.dev/docs"
+Repository = "https://github.com/tallclub/matimo"
+Issues = "https://github.com/tallclub/matimo/issues"
+
+# Matimo is a meta-package that pulls in matimo-core and optionally providers.
+# It includes a minimal __init__.py that re-exports matimo-core.
+[tool.hatch.build.targets.wheel]
+packages = ["src/matimo"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/", "README.md", "../../../LICENSE"]

matimo-0.1.0/src/matimo/__init__.py

@@ -0,0 +1,5 @@
+# Matimo meta-package.
+# This package declares dependencies on matimo-core and matimo-cli.
+# The actual `matimo` Python namespace is provided by matimo-core.
+# Install with: pip install matimo
+