GitHub - charles-azam/OmniAgents: A multi-backend execution framework for AI coding agents. Write tools once, run them anywhere.

uv add git+https://github.com/charles-azam/omniagents.git

from omniagents.agents.langchain_agent import LangChainAgent
from omniagents.backends.docker_backend import DockerBackend
from omniagents.backends.state_manager import GitStateManager
from omniagents.presets.python import PythonUVPreset
from langchain_openai import ChatOpenAI

# Create isolated Docker environment with Git-based state persistence
backend = DockerBackend(
    project_id="my-project",
    state_manager=GitStateManager()
)
backend.start()

# Create agent with Python/UV preset
agent = LangChainAgent(
    backend=backend,
    model=ChatOpenAI(model="gpt-4"),
    preset=PythonUVPreset(),
)

# Run coding task
result = agent.run("Create a FastAPI server with a /hello endpoint")
backend.shutdown()  # Saves state to Git

from omniagents.backends.local_backend import LocalBackend
from omniagents.backends.state_manager import NoOpStateManager
from omniagents.tools.write_file_tool import WriteFileTool
from omniagents.tools.run_shell_command_tool import RunShellCommandTool

# Create backend
backend = LocalBackend(project_id="demo", state_manager=NoOpStateManager())
backend.start()

# Use tools directly
write_tool = WriteFileTool(backend=backend)
write_tool.execute(absolute_path="hello.py", content="print('Hello!')")

shell_tool = RunShellCommandTool(backend=backend)
result = shell_tool.execute(command="python hello.py")
print(result.content)  # "Hello!"

backend.shutdown()

┌─────────────────────────────────────────┐
│    Layer 3: Framework Integration       │
│  smolagents, Pydantic-AI, LangChain     │
└───────────────┬─────────────────────────┘
                │
┌───────────────▼─────────────────────────┐
│    Layer 2: Core Tools                  │
│  10 Gemini CLI-inspired coding tools    │
└───────────────┬─────────────────────────┘
                │
┌───────────────▼─────────────────────────┐
│    Layer 1: Execution Backends          │
│  Local, Docker, E2B                     │
└─────────────────────────────────────────┘

# Install docs dependencies
uv sync --extra docs

# Serve documentation locally
uv run mkdocs serve

# All tests
uv run pytest tests/ -v

# Skip E2B tests (require API key)
uv run pytest tests/ -v -m "not e2b"

# Skip LLM tests (require API keys)
uv run pytest tests/ -v -m "not llm"