GP

gkvoelkl/python-selma

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

20 stars Качество 69 Тренд 18MIT

Agent Selma - Реализация OpenClaw с Python и Ollama

Обзор

это упрощенная, образовательная реализация проекта OpenClaw. Основная цель состоит в том, чтобы деконструировать и понять основную архитектуру автономных агентов, перестраивая их с нуля. Удаляя сложность, Сельма служит чистой основой для изучения взаимодействия агентных компонентов. Сельма не затвердевает для использования в производстве. Нет никаких проверок безопасности, никаких гарантий SLA и никаких гарантий стабильности или правильности. Используйте на свой страх и риск. uv должен быть установлен. Если у вас его еще нет: (для локальных моделей) — скачать и установить с ollama.com, затем вытащить модель: Ollama работает как фоновая служба автоматически после установки. Проверьте, что он работает: Для инструмента браузера (Playwright) установите Chromium один раз: Запустите скрипт настройки один раз, чтобы создать .selma / каталог, создать selma.json по умолчанию и развернуть навыки и шаблоны в рабочем пространстве:

Обзор (машинный перевод)

###Реализация «игрушки» OpenClaw с Python

Обзор

Агент Сельма является упрощенной, образовательной реализацией проекта OpenClaw.

Основная цель состоит в том, чтобы деконструировать и понять основную архитектуру автономных агентов, восстанавливая их с нуля с помощью Python. Удаляя сложность, Сельма служит чистой основой для изучения взаимодействия агентных компонентов.

[!Предупреждение] Это игрушечный проект только для учебных целей. Сельма не затвердевает для использования в производстве. Нет никаких проверок безопасности, никаких гарантий SLA и никаких гарантий стабильности или правильности. ** Не используйте его в производственных или коммерческих целях. Используйте на свой страх и риск.

Технологический стек

Компонент | Библиотека [скрыто] [скрыто] Язык Python 3.13+ LLM API | Ollama (локальный) или любой OpenAI-совместимый API Агент фреймворк Pydantic AI — посмотрите, почему он не использовался | Ворота | FastAPI + Uvicorn Обновленная панель Streamlit Телеграм-бот / Pithon-Telegram-bot Открытая телеметрия + Arize Phoenix | Web tools | Playwright, Trafilatura, DDGS | | Вдохновение | OpenClaw/PI-Agent |

###Установка

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Agent Selma 👩🏻

A “Toy” Implementation of OpenClaw with Python

🌟 Overview

Agent Selma is a simplified, educational reimplementation of the OpenClaw project.

The primary goal is to deconstruct and understand the underlying architecture of autonomous agents by rebuilding them from scratch using Python. By stripping away complexity, Selma serves as a clean baseline for learning how agentic components interact.

[!WARNING] This is a toy project for learning purposes only. Selma is not hardened for production use. There are no security audits, no SLA guarantees, and no guarantees of stability or correctness. Do not use this in any production or commercial environment. Use at your own risk.

🛠 Tech Stack

Component Library
Language Python 3.13+
LLM API Ollama (local) or any OpenAI-compatible API
Agent Framework Pydantic AI — see why it wasn’t used
Gateway FastAPI + Uvicorn
Dashboard Streamlit
Telegram Channel python-telegram-bot
Tracing OpenTelemetry + Arize Phoenix
Web tools Playwright, Trafilatura, DDGS
Inspiration OpenClaw / PI-Agent

🚀 Installation

Prerequisites: uv must be installed. If you don’t have it yet:

pip install uv
git clone https://github.com/YOUR_USERNAME/agent-selma.git
cd agent-selma
uv sync

Ollama (for local models) — download and install from ollama.com, then pull a model:

ollama pull llama3.2        # recommended default (~2 GB)
ollama pull qwen2.5:14b     # more capable, requires ~9 GB RAM

Ollama runs as a background service automatically after installation. Verify it is running:

ollama list

For the browser tool (Playwright), install Chromium once:

uv run playwright install chromium

⚙️ Configuration

Run the setup script once to create the .selma/ directory, generate a default selma.json, and deploy skills and templates into the workspace:

uv run setup.py

The script is safe to re-run — it never overwrites existing files.

The generated .selma/selma.json contains all available options with their defaults. The most important setting is the model:

"model": {
    "model": "ollama/llama3.1",
Открыть полный README на GitHub

Рекомендуемые инструменты

Попробуйте другой запрос или уберите фильтр.

Установка

npx skillfish add gkvoelkl/python-selma
Новичок в MCP? Начните с руководства на mcpskill.org →