---

name: upsonic description: "Guides Upsonic Python agent-framework workflows, including agents, models, tools, memory, RAG, teams, autonomous agents, CLI projects, interfaces, skills, and safety governance." disable-model-invocation: true metadata: disco-role: operating license: MIT

Upsonic Repo Skill

Use this skill for tasks that involve the Upsonic Python package or repository. It routes by workflow, not by source-folder shape, so future agents can answer common user requests without reopening the repo.

Route map

If the user asks about...	Read
Agent, Task, Direct, Graph, execution, streaming, structured output, run control	sub-skills/agent-runtime/SKILL.md
provider/model strings, provider inference, profiles, model selection, credentials	sub-skills/models-and-providers/SKILL.md
custom tools, @tool, ToolConfig, MCP, tool orchestration, agent-as-tool	sub-skills/tools-and-mcp/SKILL.md
Chat, Memory, session history, storage backends, user/session persistence	sub-skills/chat-memory-storage/SKILL.md
KnowledgeBase, loaders, splitters, embeddings, vector DBs, OCR, RAG	sub-skills/knowledge-rag/SKILL.md
Team, AutonomousAgent, prebuilt agents, RalphLoop, Simulation	sub-skills/teams-autonomous-prebuilt/SKILL.md
safety policies, anonymization, reflection, reliability, eval, tracing	sub-skills/quality-safety-governance/SKILL.md
Skill / Skills, loaders, validation, dependency resolution, caching	sub-skills/skills-system/SKILL.md
upsonic CLI projects, upsonic_configs.json, FastAPI /call, interfaces	sub-skills/project-cli-interfaces/SKILL.md

Install and smoke check

python -m pip install upsonic
python scripts/check_upsonic_install.py

If you need a backend-specific workflow, install the smallest matching extra instead of all optional groups.

Shared references

• references/repo-provenance.md for source snapshot freshness.
• references/package-overview.md
• references/optional-extras.md
• references/optional-extras-snapshot.json
• references/troubleshooting.md
• references/repo-routing-metadata.json

Shared scripts

• scripts/check_upsonic_install.py
• scripts/list_optional_extras.py

Guardrails

• Do not assume live API keys, databases, vector stores, OCR engines, or MCP servers are available.
• Do not leak local checkout paths, conda prefixes, or private environment details in runtime guidance.
• Prefer import/signature/CLI checks before optional service-backed checks.
• Keep cross-cutting troubleshooting in the root references and workflow-specific troubleshooting near the owning sub-skill.