An Open Source Agent Services Framework
Project description
Eidolon
An Open Source Agent Services Framework
Eidolon makes it easy to build, deploy, and manage agents and other generative ai services.
Step 0: Prerequisites
- Python 3.11
- OpenAI api key: You should have an envar OPENAI_API_KEY set to your OpenAI api key.
Step 1: Install Eidolon SDK
First, you need to install the Eidolon SDK. Open your terminal and run the following command:
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.
mkdir hello_world
vim hello_world/hello_world_agent.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.
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.
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:
{"process_id":"hello_world-1"}
Now let's try to make a request to your server from another terminal window.
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.
Further Reading
For full documentation, visit www.eidolonai.com.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for eidolon_ai_sdk-0.1.33-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 13cceb8cb93ec7ff10cb3dcee98871a0a27d67a42326a173526e4b4255bb0e8f |
|
MD5 | 09e5f199f034ff0af38151fb51b317cd |
|
BLAKE2b-256 | 841a2260384e011cecad54d8f746f215fae16f903a09dad36e9e7b526a2353d3 |