https://github.com/muka/calendula
A blooming LLM agents experiment
https://github.com/muka/calendula
Last synced: 2 months ago
JSON representation
A blooming LLM agents experiment
- Host: GitHub
- URL: https://github.com/muka/calendula
- Owner: muka
- License: apache-2.0
- Created: 2025-01-04T15:34:49.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-02-09T16:42:53.000Z (3 months ago)
- Last Synced: 2025-02-09T17:32:54.006Z (3 months ago)
- Language: TypeScript
- Size: 149 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Calendula LLM agents
Experiments over agentic approaches with LLM. This is an educative project which selectively tries to avoid more structured frameworks.
It uses MCP as repositories for tools, prompts and resources.
In `./config` there is a sample YAML to configure agents and tasks to perform to develop a TODO list web application and a SOTA for REC in Europe.
## Setup
**Note:** This project uses [Task](https://taskfile.dev/) for automation, consider installing to ease the setup.
1. Install dependencies with a package manger e.g. `npm i`
2. Build the base image for the MCP proxy
```sh
docker build ./mcp/mcp-proxy-base -f ./mcp/mcp-proxy-base/Dockerfile -t mcp-proxy/base
docker build ./mcp/mcp-servers -f ./mcp/mcp-servers/Dockerfile.base -t mcp-proxy/servers-base
```
3. Create a `.env` in the root folder and set the those api keys
```
# openai api key
OPENAI_API_KEY=...
# serper.dev api key
SERPER_API_KEY=...
```
4. Add or edit tasks definition in `./config`
## Usage
Start the MCP servers to be used by the agents.
`docker compose -f docker-compose.mcp.yaml up -d`
Start the main runtime with `docker compose up`
## License
Copyright 2025 Luca Capra
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.