openfren 0.1.0

Your robot fren that reacts to Internet Capital Markets using Alphakek Fractal knowledge engine as its brain.

Openfren

Proof-of-Concept. Your robot fren that reacts to changes in Internet Capital Markets using Alphakek Fractal knowledge engine as its brain. Free and open source.

Release notes

TODO

• Fractal 2 integration
• Voice commands
  • Conversation mode
• Face tracking
  • Emotion recognition
  • Face recognition (local, on-device)

Installation

Using uv (recommended for dev):

uv sync

From PyPI (runtime only):

pip install openfren

Configuration

• Environment variables (only these are configurable):
  • AIKEK_API_TOKEN — required. Obtain one at https://app.alphakek.ai
  • AIKEK_QUESTION — optional, default: "crypto market sentiment now, one line"

You may pass environment variables directly or via a .env file. See env.example for a template.

Run

If you don't have the physical robot yet, first start the simulation:

uv run reachy-mini-daemon --sim --scene minimal

If you have a robot, just start the daemon:

uv run reachy-mini-daemon

Then start Openfren:

uv run openfren

Test

uv run pytest

Notes

• Developed and regularly tested on Linux. macOS/Windows should work (best‑effort), but are not as thoroughly validated.
• Requires Reachy Mini hardware or the simulator daemon.

Development

See DEVELOPMENT.md for architecture overview and contributor/developer details.

Credits

• Reachy Mini by Pollen Robotics
• Emotions dataset: pollen-robotics/reachy-mini-emotions-library