API Reference

April 17, 2026 ยท View on GitHub

NexusAgent

from nexus.agent import NexusAgent

agent = NexusAgent(model="ollama/llama3")

Methods

MethodParametersReturnsDescription
execute(prompt)prompt: strstrExecute a task with the agent
evolve()โ€”dictScan workspace and build memory graph

Configuration

from nexus.config import load_config, save_config, NexusConfig

config = load_config()           # Load from ~/.nexus/config.yaml
config.model.default = "ollama/codellama"
save_config(config)              # Save to file

NexusConfig Fields

FieldTypeDefaultDescription
model.defaultstr"ollama/llama3"Default model
model.max_tokensint2048Max tokens per response
model.temperaturefloat0.7Model temperature
memory.max_nodesint10000Max graph nodes
memory.max_edgesint50000Max graph edges
skills.directorystr".nexus/skills"Skills storage
skills.sandbox_enabledboolTrueEnable sandbox
plugins.directorystr".nexus/plugins"Plugins storage
plugins.hot_reloadboolTrueAuto-reload plugins
web.enabledboolFalseEnable dashboard
web.portint8420Dashboard port

Plugin Manager

from nexus.plugins import PluginManager

pm = PluginManager()
pm.load_all()
pm.call_hook("nexus_pre_execute", "Hello!")
plugins = pm.list_plugins()

Sandbox

from nexus.sandbox import Sandbox

sandbox = Sandbox(timeout=30, max_memory_mb=256)
result = sandbox.execute("print('Hello!')")
print(result.stdout)       # "Hello!"
print(result.success)      # True

Export

from nexus.export import export_skills_json, export_markdown_report, export_skill_pack

export_skills_json(agent, "skills.json")
export_markdown_report(agent, "report.md")
export_skill_pack(agent, "pack.zip")

Updater

from nexus.updater import check_version, update_skills, self_update

version_info = check_version()
update_skills()
self_update()