PHPackages                             hyperf/odin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. hyperf/odin

ActiveLibrary

hyperf/odin
===========

v0.2.1(2mo ago)425.9k↓33.3%9[1 PRs](https://github.com/hyperf/odin/pulls)MITPHPPHP >=8.1CI passing

Since Jul 21Pushed 2mo ago5 watchersCompare

[ Source](https://github.com/hyperf/odin)[ Packagist](https://packagist.org/packages/hyperf/odin)[ Fund](https://hyperf.wiki/#/zh-cn/donate)[ Fund](https://opencollective.com/hyperf)[ RSS](/packages/hyperf-odin/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (37)Versions (21)Used By (0)

English | [中文](README-CN.md)

Odin
====

[](#odin)

Odin is a PHP-based LLM application development framework. Its naming is inspired by the chief god Odin from Norse mythology and his two ravens Huginn and Muninn, which represent **thought** and **memory** respectively. Every morning at dawn, they fly to the human world and return in the evening to bring back what they have seen and heard to Odin. This project aims to help developers create more intelligent and flexible applications using LLM technology, providing more possibilities for LLM technology implementation through a series of powerful and easy-to-use features.

Core Features
-------------

[](#core-features)

- **Multi-Model Support**: Supports various large language models including OpenAI, Azure OpenAI, AWS Bedrock, Doubao, ChatGLM, and more
- **Unified Interface**: Provides consistent API interface, simplifying integration with different LLM providers
- **Tool Calling**: Supports Function Calling, allowing models to invoke custom tools and functions
- **MCP Integration**: Based on [dtyq/php-mcp](https://github.com/dtyq/php-mcp) to implement Model Context Protocol support, easily integrating external tools and services
- **Memory Management**: Provides flexible memory management system, supporting conversation context persistence
- **Vector Storage**: Integrates Qdrant vector database, supporting knowledge retrieval and semantic search
- **Agent Development**: Built-in Agent framework, supporting intelligent agent development
- **High Performance**: Optimized implementation, supporting streaming responses and efficient processing

System Requirements
-------------------

[](#system-requirements)

- PHP >= 8.0
- PHP Extensions: bcmath, curl, mbstring
- Composer >= 2.0
- Hyperf Framework (2.2.x, 3.0.x or 3.1.x)

Installation
------------

[](#installation)

```
composer require hyperf/odin
```

Quick Start
-----------

[](#quick-start)

1. After installation, publish the configuration files:

```
php bin/hyperf.php vendor:publish hyperf/odin
```

2. Configure your API key in the `.env` file:

```
OPENAI_API_KEY=your_openai_api_key

```

3. Set the default model in `config/autoload/odin.php`:

```
return [
    'llm' => [
        'default' => 'gpt-4o', // Set your default model
        // ... other configurations
    ],
];
```

Documentation
-------------

[](#documentation)

Detailed documentation can be found in the `doc/user-guide` directory:

- [Installation and Configuration](doc/user-guide/01-installation.md)
- [Core Concepts](doc/user-guide/02-core-concepts.md)
- [API Reference](doc/user-guide/03-api-reference.md)
- [Model Providers](doc/user-guide/04-model-providers.md)
- [Tool Development](doc/user-guide/05-tool-development.md)
- [Memory Management](doc/user-guide/06-memory-management.md)
- [Agent Development](doc/user-guide/07-agent-development.md)
- [Example Projects](doc/user-guide/09-examples.md)
- [MCP Integration](doc/user-guide/11-mcp-integration.md)
- [Frequently Asked Questions](doc/user-guide/10-faq.md)

License
-------

[](#license)

Odin is open-sourced software licensed under the [MIT license](https://github.com/hyperf/odin/blob/master/LICENSE).

###  Health Score

50

—

FairBetter than 96% of packages

Maintenance85

Actively maintained with recent releases

Popularity36

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 71.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~49 days

Recently: every ~70 days

Total

19

Last Release

76d ago

PHP version history (2 changes)v0.0.1PHP >=8.1

v0.0.2PHP >=8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/44228082?v=4)[Hyperf Community](/maintainers/hyperf)[@hyperf](https://github.com/hyperf)

---

Top Contributors

[![lihq1403](https://avatars.githubusercontent.com/u/25847339?v=4)](https://github.com/lihq1403 "lihq1403 (228 commits)")[![huangzhhui](https://avatars.githubusercontent.com/u/12077148?v=4)](https://github.com/huangzhhui "huangzhhui (81 commits)")[![huangdijia](https://avatars.githubusercontent.com/u/8337659?v=4)](https://github.com/huangdijia "huangdijia (5 commits)")[![assert6](https://avatars.githubusercontent.com/u/28561563?v=4)](https://github.com/assert6 "assert6 (2 commits)")[![huanghantao](https://avatars.githubusercontent.com/u/22836925?v=4)](https://github.com/huanghantao "huanghantao (1 commits)")

---

Tags

phphyperf

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/hyperf-odin/health.svg)

```
[![Health](https://phpackages.com/badges/hyperf-odin/health.svg)](https://phpackages.com/packages/hyperf-odin)
```

###  Alternatives

[hyperf/swow-skeleton

A coroutine framework that focuses on hyperspeed and flexible, specifically use for build microservices and middlewares.

514.5k](/packages/hyperf-swow-skeleton)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)