Skip to content

Installation

Install Floki

Info

make sure you have Python already installed. Python >=3.9

As a Python package using Pip

pip install floki-ai

Remotely from GitHub

pip install git+https://github.com/Cyb3rWard0g/floki.git

From source with poetry:

git clone https://github.com/Cyb3rWard0g/floki

cd floki

poetry install

Install Dapr CLI

Install the Dapr CLI to manage Dapr-related tasks like running applications with sidecars, viewing logs, and launching the Dapr dashboard. It works seamlessly with both self-hosted and Kubernetes environments. For a complete step-by-step guide, visit the official Dapr CLI installation page.

Verify the CLI is installed by restarting your terminal/command prompt and running the following:

dapr -h

Initialize Dapr in Local Mode

Info

Make sure you have Docker already installed. I use Docker Desktop.

Initialize Dapr locally to set up a self-hosted environment for development. This process fetches and installs the Dapr sidecar binaries, runs essential services as Docker containers, and prepares a default components folder for your application. For detailed steps, see the official guide on initializing Dapr locally.

To initialize the Dapr control plane containers and create a default configuration file, run:

dapr init

Verify you have container instances with daprio/dapr, openzipkin/zipkin, and redis images running:

docker ps

Enable Redis Insights

Dapr uses Redis by default for state management and pub/sub messaging, which are fundamental to Floki's agentic workflows. These capabilities enable the following:

  • Viewing Pub/Sub Messages: Monitor and inspect messages exchanged between agents in event-driven workflows.
  • Inspecting State Information: Access and analyze shared state data among agents.
  • Debugging and Monitoring Events: Track workflow events in real time to ensure smooth operations and identify issues.

To make these insights more accessible, you can leverage Redis Insight.

docker run --rm -d --name redisinsight -p 5540:5540 redis/redisinsight:latest

Once running, access the Redis Insight interface at http://localhost:5540/

Connection Configuration

  • Port: 6379
  • Host (Linux): 172.17.0.1
  • Host (Windows/Mac): docker.host.internal

Redis Insight makes it easy to visualize and manage the data powering your agentic workflows, ensuring efficient debugging, monitoring, and optimization.