General

General

The Orion101 server is configured through environment variables, which allow you to customize its functionality and integrate it with external services. Below is a breakdown of the key configuration options available in Orion101:

---

OPENAI_API_KEY

The foundation of Orion101 is a large language model (LLM) that supports function-calling capabilities. By default, Orion101 integrates with OpenAI's models. Specifying an OpenAI API key using this variable ensures that end-users do not need to supply their own API key for interactions.

Note: In addition to OpenAI, Orion101 supports other model providers, which can also be configured.

---

GITHUB_AUTH_TOKEN

Orion101 and its underlying tools make extensive use of components hosted on GitHub. To avoid rate-limiting issues when fetching or updating these tools, you can configure a read-only GitHub token with this environment variable. This ensures smoother operation and reduces the frequency of API request failures due to rate limits.

---

ORION101_SERVER_DSN

Orion101 relies on a database backend for storing its configurations, threads, workflows, and other essential data. By default, it uses a local sqlite3 database. However, this variable allows you to specify an alternative database backend, such as PostgreSQL. For example, to use a PostgreSQL database, you would set the following:

ORION101_SERVER_DSN=postgres://user:password@host/database

This flexibility ensures Orion101 can scale to meet the needs of larger deployments.

---

ORION101_SERVER_HOSTNAME

This variable specifies the server URL for Orion101. Providing a hostname ensures that features such as OAuth integrations, LLM proxying, and workflow invocation URLs are handled correctly. Proper configuration of the server hostname is crucial for seamless operation, especially when integrating with external services or exposing the system to users.