Skip to content

Jiashu329/AgentS

AgentS Banner

AgentS

Your AI Digital Asset Management Hub

License: MIT Next.js FastAPI Docker

English | 简体中文


AgentS is an open-source, self-hosted platform designed to manage your AI Agents as true digital assets. It treats an AI's Soul (Persona), Skills (Toolsets), and Memory (Context) as portable, localized assets that you own and control.

✨ Key Features

  • 🛡️ Asset Ownership: All agent data is stored as local Markdown files. Your AI assets stay with you, independent of any specific UI or platform.
  • 🧠 Soul & Skill Architecture: Manage complex agent configurations with a structured approach.
    • Soul: Core identity and system prompts.
    • Skills: Version-controlled toolsets and capabilities.
    • Memory: Deep, context-aware knowledge fragments.
  • 🚀 One-Click Portability: Effortlessly transfer assets between ChatGPT, Claude, Gemini, or Cursor using our standardized transfer protocol.
  • 📚 Prompt Management: A high-performance personal prompt library with full-text search and tagging.
  • 🌍 Internationalization: Built-in support for English and Chinese.
  • 💎 Premium UI: A "Cyber-Refined" interface built with Next.js 15, Tailwind v4, and Shadcn UI.

🛠️ Architecture

AgentS follows a "Data-Centric" architecture where the filesystem is the source of truth, and a lightweight database provides metadata indexing.

  • Frontend: Next.js 15 (App Router), Tailwind CSS v4, Milkdown (Markdown Editor).
  • Backend: FastAPI (Python), SQLite (Metadata Indexing), Pydantic.
  • Storage: Flat Markdown files in data/ for maximum transparency and Git-friendliness.

🚀 Quick Start

Using Docker Compose (Recommended)

docker-compose up -d

Local Development

Backend

cd backend
pip install -r requirements.txt
python -m app.main

Frontend

cd frontend
npm install
npm run dev

📂 Data Structure

Your data is organized transparently:

  • /data/agents/: Asset folders organized by Agent ID.
  • /data/prompts/: Global prompt templates.
  • agents.db: Metadata index for lightning-fast search.

🤝 Contributing

We welcome all contributions! Please see our Contributing Guidelines and Code of Conduct.

📄 License

This project is licensed under the MIT License.

About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors