-
Notifications
You must be signed in to change notification settings - Fork 29
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
5 changed files
with
61 additions
and
86 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,22 @@ | ||
# Eidolon Client | ||
[![Website Link](https://img.shields.io/badge/EidolonAI.com-grey)](https://www.eidolonai.com/docs/introduction/) | ||
[![GitHub Org stars](https://img.shields.io/github/stars/eidolon-ai?style=flat&logo=github)](https://github.com/eidolon-ai/eidolon) | ||
[![PyPI - Version](https://img.shields.io/github/actions/workflow/status/eidolon-ai/eidolon/test.yml?style=flat&label=test)](https://github.com/eidolon-ai/eidolon) | ||
|
||
## Eidolon Client and CLI | ||
|
||
This package contains a python client to interact with the Eidolon API. It also contains a CLI which can be called with `eidolon-cli`. | ||
```bash | ||
eidolon-cli --help | ||
``` | ||
|
||
Visit [www.eidolonai.com](https://www.eidolonai.com/) for more details. | ||
|
||
🚨 To install the dependencies needed for the CLI run the following command: | ||
```bash | ||
pip install 'eidolon-ai-client[cli]' | ||
``` | ||
|
||
## Thanks for your support | ||
|
||
Eidolon is completely open source and free to use. If you like this project, [give it a star](https://github.com/eidolon-ai/eidolon) 🌟! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,85 +1,15 @@ | ||
# Eidolon | ||
## An Open Source Agent Services Framework | ||
# Eidolon SDK | ||
[![Website Link](https://img.shields.io/badge/EidolonAI.com-grey)](https://www.eidolonai.com/docs/introduction/) | ||
[![GitHub Org stars](https://img.shields.io/github/stars/eidolon-ai?style=flat&logo=github)](https://github.com/eidolon-ai/eidolon) | ||
[![PyPI - Version](https://img.shields.io/github/actions/workflow/status/eidolon-ai/eidolon/test.yml?style=flat&label=test)](https://github.com/eidolon-ai/eidolon) | ||
|
||
## An Open Source Agent Service SDK | ||
|
||
Eidolon makes it easy to build, deploy, and manage agents and other generative ai services. | ||
|
||
Eidolon makes it easy to build, deploy, and manage agents and other genAI services. | ||
|
||
### Step 0: Prerequisites | ||
Visit [www.eidolonai.com](https://www.eidolonai.com/) for more details. | ||
|
||
* [Python 3.11](https://formulae.brew.sh/formula/python@3.11) | ||
* [OpenAI api key](https://platform.openai.com/account/api-keys): You should have an envar OPENAI_API_KEY set to your OpenAI api key. | ||
## Thanks for your support | ||
|
||
### Step 1: Install Eidolon SDK | ||
|
||
First, you need to install the Eidolon SDK. Open your terminal and run the following command: | ||
|
||
```bash | ||
pip install eidolon-ai-sdk | ||
``` | ||
|
||
### Step 2: Create an Agent | ||
|
||
Now it is time to create your first **AgentProgram**. Create a directory and add a yaml file to describe your resource. | ||
|
||
```bash | ||
mkdir hello_world | ||
vim hello_world/hello_world_agent.yaml | ||
``` | ||
|
||
```yaml | ||
apiVersion: eidolon/v1 | ||
kind: Agent | ||
metadata: | ||
name: hello_world | ||
spec: | ||
description: "This is an example of a generic agent which greets people by name." | ||
system_prompt: "You are a friendly greeter who greets people by name while using emojis" | ||
actions: | ||
user_prompt: "Hi, my name is {{name}}" | ||
``` | ||
### Step 3: Run Eidolon Server | ||
Finally, open a new terminal window and run your machine using eidolon-server. | ||
```bash | ||
eidolon-server -m local_dev hello_world | ||
``` | ||
🚨 Getting `command not found: eidolon-server`? Open a new terminal window and try the command again. | ||
|
||
⚠️ The `-m local_dev` option specifies using the `local_dev` builtin Machine resource. This machine uses in-memory symbolic memory rather than mongo, so state will disappear between server restarts. | ||
|
||
### Step 4: Try it out! | ||
|
||
First create a process for your conversation. | ||
|
||
```bash | ||
curl -X 'POST' 'http://localhost:8080/processes' -H 'Content-Type: application/json' -d '{ | ||
"agent": "hello_world", | ||
"title": "quickstart" | ||
}' | ||
```` | ||
|
||
The result should be a json object with a process id. For example: | ||
|
||
```json | ||
{"process_id":"hello_world-1"} | ||
``` | ||
|
||
Now let's try to make a request to your server from another terminal window. | ||
```bash | ||
curl -X POST http://0.0.0.0:8080/processes/{process_id}/agent/hello_world/actions/converse -H 'Content-Type: application/json' -d '{"name": "World"}'; echo | ||
``` | ||
Replace `{process_id}` with the process id you received from the previous command. | ||
You should now see something like `Hello, World! 🌍👋` | ||
And that's it! You have successfully set up and used a basic project using the Eidolon SDK. To see more endpoints on your agent machine, visit the [swagger ui](http://0.0.0.0:8080/docs). | ||
|
||
### Further Reading | ||
|
||
For full documentation, visit [www.eidolonai.com](https://www.eidolonai.com/). | ||
Eidolon is completely open source and free to use. If you like this project, [give it a star](https://github.com/eidolon-ai/eidolon) 🌟! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters