sagentic-af｜构建与本地运行自主智能体的TypeScript框架

access：来源确认 · npx @sagentic-ai/sagentic-af init my-project

project_type：来源确认 · Sagentic.ai Agent Framework comes with a dev server with hot reloading.

# 😎 Sagentic.ai Agent Framework

Visit [sagentic.ai](https://sagentic.ai) for more information.

Join our [Discord server](https://discord.gg/VmEEUrc7dg) for support and discussions.

## 📦 Installation

To create a new Sagentic.ai Agent Framework project, run the following command and follow the instructions:

```bash
npx @sagentic-ai/sagentic-af init my-project
```

It will create `my-project` directory and set up a fresh Sagentic.ai Agent Framework project there.

Remember to install dependencies with `yarn` or `npm install`!

See the [documentation](https://sagentic.ai/installation.html) for more information.

## 📚 Documentation

The documentation for the Sagentic.ai Agent Framework can be found [here](https://sagentic.ai/introduction.html).

## 🚀 Usage

Sagentic.ai Agent Framework comes with a dev server with hot reloading. To start it, run the following command:

```bash
yarn dev
# or
npm run dev
```

You can spawn agents locally by calling `/spawn` endpoint:

```bash
curl -X POST http://localhost:3000/spawn \
    -H "Content-Type: application/json" \
    -d '{"type": "my-project/MyAgent",
        "options": {
            ...
        }'
```

See the [documentation](https://sagentic.ai/first-agent.html) for more information.

## 🤝 Contributing

Contributions, issues and feature requests are welcome!

Check our [issues page](https://github.com/sagentic-ai/sagentic-af/issues).

## 📝 License

This project is licensed under the [Business Source License 1.1](LICENSE).

For information about alternative licensing arrangements for the Licensed Work, please contact hello@sagentic.ai.

Copyright (c) 2023-2025 Ahyve AI Inc.

需 Node.js 与 npm/yarn 环境（README 给出 yarn 与 npm install 两种方式，具体版本未说明，待核验）；需通过 npx 获取 @sagentic-ai/sagentic-af 包；模型/API Key 需求未说明，待核验；Sagentic.ai 平台服务费用未提供，待核验；涉及境外 npm 源与官方域名访问，国内可达性待核验。