Mindsherpa API is a REST interface for the Mindsherpa platform. This powerful application enables users to generate and manage focus items such as tasks, events, and emotions. These items can be created from both text and voice inputs. Additionally, users can engage with a chat interface that discusses topics while referencing their focus items.
- Generate focus items from text input
- Generate focus items from voice input
- Interactive chat interface that references focus items
- RESTful API for seamless integration
The Mindsherpa API relies on the following technologies:
- Docker
- Python 3.11
uv
(Python package installer and resolver)- FastAPI
- PostgreSQL
- Langchain
- OpenAI
- Groq
- Chroma
To set up the Mindsherpa API locally, follow these steps:
-
Clone the repository:
git clone https://github.com/your-username/mindsherpa-api.git cd mindsherpa-api
-
Create and activate a virtual environment using
uv
:uv venv source .venv/bin/activate # On Windows, use `.venv\Scripts\activate`
-
Install dependencies:
uv sync
-
Build and start the Docker containers:
docker compose up --build -d
-
The API will be available at
http://localhost:8002
Once the application is running, you can interact with the API using your preferred HTTP client or integrate it into your application.
[Consider adding some basic endpoint information or linking to more detailed API documentation]
We welcome contributions to the Mindsherpa API! If you're interested in helping improve this project, please [guidelines for contributing, if available].
- Add a license file
For questions, support, or feedback, please create an issue.