Codearkt

IlyaGusev40stars

Implementation of the CodeAct agentic framework with Docker containers for security, MCP servers for tool integrations, and multi-agent support.

Autonomous Agents Devops

Install Run on PlugMCP

GitHub

Run on PlugMCP

1# Codearkt

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: Apache-2.0
Last checked: 2026-10-27

Stars: 40
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Codearkt?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Codearkt need an API key?

No required environment variable is listed on this record.

What transport does Codearkt use?

Codearkt runs locally over stdio.

When was Codearkt last checked?

Last checked 2026-10-27. Implementation of the CodeAct agentic framework with Docker containers for security, MCP servers for tool integrations, and multi-agent support.

From the publisher

Documentation

CodeArkt

CodeArkt is a battery-included implementation of the CodeAct framework with support for the multi-agent architecture. Ship autonomous agents that can reason, write, execute & iterate over code. All from a single Python package.

✨ Why CodeArkt?

Multi-agent orchestration – coordinate hierarchies of specialist agents.
Secure Python sandbox – secure, ephemeral Docker execution environment for code actions.
First-class tool ecosystem – auto-discover & register MCP tools.
Drop-dead simple UI – launch an elegant Gradio chat or run the terminal client.
Production ready – typed codebase (mypy --strict), CI, tests, Docker & Apache-2.0 license.

🚀 Quick Start

Install the package:

pip install codearkt  # requires Python ≥ 3.12

Run your MCP servers:

python -m academia_mcp --port 5056 # just an example MCP server

Run a server with a simple agent and connect it to your MCP servers:

import os
from codearkt.codeact import CodeActAgent
from codearkt.llm import LLM
from codearkt.server import run_server

# Use your own or remote MCP servers
mcp_config = {
    "mcpServers": {"academia": {"url": "http://0.0.0.0:5056/mcp", "transport": "streamable-http"}}
}

# Create an agent definition
api_key = os.getenv("OPENROUTER_API_KEY", "")
assert api_key, "Please provide OpenRouter API key!"
agent = CodeActAgent(
    name="manager",
    description="A simple agent",
    llm=LLM(model_name="deepseek/deepseek-chat-v3-0324", api_key=api_key),
    tool_names=["arxiv_download", "arxiv_search"],
)

# Run the server with MCP proxy and agentic endpoints
run_server(agent, mcp_config, port=5055)

Now run a Python client:

from codearkt.client import query_agent
from codearkt.llm import ChatMessage

history = [ChatMessage(role="user", content="Find an abstract of the 2402.01030 paper")]

for event in query_agent(history, port=5055):
    if event.content:
        print(event.content, end="", flush=True)

Within seconds, you will see agents collaborating, executing Python snippets, and streaming the results back to your console.

You can also use existing clients, Gradio and terminal:

uv run -m codearkt.terminal --port 5055
uv run -m codearkt.gradio --port 5055

🧩 Feature Overview

Area	Highlights
Agents	Hierarchical manager / worker pattern, pluggable prompts, configurable iteration limits
Tools	Automatic discovery via MCP registry, Python execution (`python_interpreter`)
Execution	Sandboxed temp directory, timeout, streamed chunks, cleanup hooks
Observability	`AgentEventBus` publishes JSON events – integrate with logs, websockets, or GUI. Opentelemetry is also supported.
UI	Responsive Gradio Blocks chat with stop button, syntax-highlighted code & output panels
Extensibility	Compose multiple `CodeActAgent` instances, add your own LLM backend, override prompts

📖 Documentation

For now, explore the well-typed source code.

🛠️ Project Structure

codearkt/
├─ codeact.py          # Core agent logic
├─ python_executor.py  # Secure sandbox for arbitrary code
├─ event_bus.py        # Pub/Sub for agent events
├─ gradio.py           # Optional web UI
└─ ...
examples/
└─ multi_agent/        # End-to-end usage demos

🤝 Contributing

Pull requests are welcome! Please:

Fork the repo & create your branch: git checkout -b feature/my-feature
Install dev deps: make install
Run the linter & tests: make validate && make test
Submit a PR and pass the CI.

Join the discussion in Discussions or open an Issue.

📝 License

CodeArkt is released under the Apache License 2.0 – see the LICENSE file for details.

Codearkt

IlyaGusev40stars

Implementation of the CodeAct agentic framework with Docker containers for security, MCP servers for tool integrations, and multi-agent support.

Autonomous Agents Devops

Install Run on PlugMCP

GitHub

Run on PlugMCP

1# Codearkt

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: Apache-2.0
Last checked: 2026-10-27

Stars: 40
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Codearkt?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Codearkt need an API key?

No required environment variable is listed on this record.

What transport does Codearkt use?

Codearkt runs locally over stdio.

When was Codearkt last checked?

Last checked 2026-10-27. Implementation of the CodeAct agentic framework with Docker containers for security, MCP servers for tool integrations, and multi-agent support.

From the publisher

Documentation

CodeArkt

✨ Why CodeArkt?

Multi-agent orchestration – coordinate hierarchies of specialist agents.
Secure Python sandbox – secure, ephemeral Docker execution environment for code actions.
First-class tool ecosystem – auto-discover & register MCP tools.
Drop-dead simple UI – launch an elegant Gradio chat or run the terminal client.
Production ready – typed codebase (mypy --strict), CI, tests, Docker & Apache-2.0 license.

🚀 Quick Start

Install the package:

pip install codearkt  # requires Python ≥ 3.12

Run your MCP servers:

python -m academia_mcp --port 5056 # just an example MCP server

Run a server with a simple agent and connect it to your MCP servers:

import os
from codearkt.codeact import CodeActAgent
from codearkt.llm import LLM
from codearkt.server import run_server

# Use your own or remote MCP servers
mcp_config = {
    "mcpServers": {"academia": {"url": "http://0.0.0.0:5056/mcp", "transport": "streamable-http"}}
}

# Create an agent definition
api_key = os.getenv("OPENROUTER_API_KEY", "")
assert api_key, "Please provide OpenRouter API key!"
agent = CodeActAgent(
    name="manager",
    description="A simple agent",
    llm=LLM(model_name="deepseek/deepseek-chat-v3-0324", api_key=api_key),
    tool_names=["arxiv_download", "arxiv_search"],
)

# Run the server with MCP proxy and agentic endpoints
run_server(agent, mcp_config, port=5055)

Now run a Python client:

from codearkt.client import query_agent
from codearkt.llm import ChatMessage

history = [ChatMessage(role="user", content="Find an abstract of the 2402.01030 paper")]

for event in query_agent(history, port=5055):
    if event.content:
        print(event.content, end="", flush=True)

Within seconds, you will see agents collaborating, executing Python snippets, and streaming the results back to your console.

You can also use existing clients, Gradio and terminal:

uv run -m codearkt.terminal --port 5055
uv run -m codearkt.gradio --port 5055

🧩 Feature Overview

Area	Highlights
Agents	Hierarchical manager / worker pattern, pluggable prompts, configurable iteration limits
Tools	Automatic discovery via MCP registry, Python execution (`python_interpreter`)
Execution	Sandboxed temp directory, timeout, streamed chunks, cleanup hooks
Observability	`AgentEventBus` publishes JSON events – integrate with logs, websockets, or GUI. Opentelemetry is also supported.
UI	Responsive Gradio Blocks chat with stop button, syntax-highlighted code & output panels
Extensibility	Compose multiple `CodeActAgent` instances, add your own LLM backend, override prompts

📖 Documentation

For now, explore the well-typed source code.

🛠️ Project Structure

codearkt/
├─ codeact.py          # Core agent logic
├─ python_executor.py  # Secure sandbox for arbitrary code
├─ event_bus.py        # Pub/Sub for agent events
├─ gradio.py           # Optional web UI
└─ ...
examples/
└─ multi_agent/        # End-to-end usage demos

🤝 Contributing

Pull requests are welcome! Please:

Fork the repo & create your branch: git checkout -b feature/my-feature
Install dev deps: make install
Run the linter & tests: make validate && make test
Submit a PR and pass the CI.

Join the discussion in Discussions or open an Issue.

📝 License

CodeArkt is released under the Apache License 2.0 – see the LICENSE file for details.