GitHub - Oneirocom/Magick: Magick is a cutting-edge toolkit for a new kind of AI builder. Make Magick with us!

Join Discord Follow on Twitter Follow on LinkedIn Subscribe on YouTube

Magick is a groundbreaking visual AIDE (Artificial Intelligence Development Environment) for no-code data pipelines and multimodal agents. Magick can connect to other services and comes with nodes and templates well-suited for intelligent agents, chatbots, complex reasoning systems and realistic characters.

šŸ— Key Features

  • Realtime agents which can perform actions on their own, interact with users and other agents in different modalities with a unified memory and self
  • Social connectors to Discord, Twitter and Twilio -- Zoom, Google Meet, Reddit, Slack connectors will be available soon as plugins!
  • Search Google, Wikipedia and the Semantic Web
  • Many included powertools, including voice and image generation and vector search
  • Powerful graph-based IDE for complex data pipelines
  • Graphs can be embedded in subgraphs and shared for rapid community development.

šŸ”® Magick: Automate, Build, and Bring Your Ideas to Life with AI.

With Magick, you can unleash the power of AI without needing to know how to code everything in a command line interface. Using our visual node based environment, you can connect to popular services and explore a world of pre-built nodes and connectors to bring your vision to life.

Magick - AI for Mere Mortals
ā–¶ļø Click the image above to watch the video

Core Concepts

Spells

A spell is a pipeline that describes data moving from one place to another, running through different processes we call "nodes", via wires we call "connections". In Magick, the collection of data, nodes, variables, and presets for each graph is known as a "spell". Spell is not a machine learning term.

We just like it. Spells can be imported and exported at any time. Spells in their raw form are JSON, a standard format that is easy to share.

Nodes

At the core, Magick is a system for taking in data, doing stuff to it, and then sending the final data out.

This "stuff" is called a "transformation", the data transforms from one thing into the next. The "stuff" that is happening to the data is a black box that takes something in, anything, and returns something out.

We call the black box where the transformstion takes place a "node". Nodes are the building blocks of Magick.

Creating Nodes

Nodes are created in the composer window of the "Spells" tab. You can right-click in the composer and add nodes from the context menu. You can also drag and drop nodes from the "Nodes" tab into the composer. Nodes can be dragged and dropped around the composer to re-arrange them.

Nodes can be deleted by right-clicking on them and selecting "Delete".

Node Types

  • Input Node
  • Prompt Template
  • Code Node: Lets you define both inputs and outputs.
  • Generator Node: Lets you define your own input sockets and then work with that data inside of the node.
  • Wait For All Node: Used to wait for different execution branches to complete before joining back into a single branch -- this is a good way to do several slow tasks at once.
  • ...and lots more! (if you have suggestions for any, do let us know)

Inputs and Outputs

All nodes have some inputs and/or outputs, although they don't necessarily have to have both. Inputs and outputs are visually displayed as sockets. The color of the socket determines the type of data it can receive, with "gray" being the default untyped or "any" type.

Sockets

Data passed into sockets is available to the node. It can process that data, do something to it, and return the result to the output socket. Some nodes (like Generator node) let you define your own input sockets and then work with that data inside of the node. Some nodes (like the Code node) let you define both inputs and outputs.

Triggers

Triggers tell nodes to start asynchronous tasks. Some nodes can process data without needing a trigger, but most nodes need triggers. Triggers can be emitted from one socket out to more than one input, however the order of execution is not guaranteed. You can use the "Wait For All" node to wait for different execution branches to complete before joining back into a single branch -- this is a good way to do several slow tasks at once


āš™ļø Installation

Choose your operating system's installation guide for detailed setup instructions:

Each guide includes:

  • System requirements and prerequisites
  • Step-by-step installation instructions
  • Environment setup
  • Database configuration
  • Troubleshooting tips

For detailed development documentation and architecture overview, see:

Development Tips

Self-signed certificates

For local development, you may want to have Chrome accept self-signed certificates from localhost. To enable this:

  1. Navigate to: chrome://flags/#allow-insecure-localhost
  2. Enable the feature

Contributors

All Contributors

Michael
Michael

šŸ’» šŸ“¦ šŸ’¼
MĢµĶĢ…ĢĢŽĢžĢ—ĢĢ¼OĢ“Ģ‡ĢŠĢƒĢ‹Ģ€ĢĢ»OĢ·ĢƒĶ‹Ģ¼N̸̩̿͜ Ģ¶Ķ’ĢœĢ Ģ¹Ģ¼Ģ©
MĢµĶĢ…ĢĢŽĢžĢ—ĢĢ¼OĢ“Ģ‡ĢŠĢƒĢ‹Ģ€ĢĢ»OĢ·ĢƒĶ‹Ģ¼N̸̩̿͜ Ģ¶Ķ’ĢœĢ Ģ¹Ģ¼Ģ©

šŸ’» šŸ“¦
alextitonis
alextitonis

šŸ’»
Daniel Adams
Daniel Adams

šŸ’»
Anthony Burchell
Anthony Burchell

šŸ’» šŸ“
jin
jin

šŸ“
Shivaditya Shivganesh
Shivaditya Shivganesh

šŸ’»
khalildh
khalildh

šŸ’»
Pigloo
Pigloo

šŸ’»
avirtualfuture
avirtualfuture

šŸ’» šŸ“–
Alexandre Ferreira
Alexandre Ferreira

šŸ’»
Matei Anghel
Matei Anghel

šŸ’»
Trentalantar
Trentalantar

šŸ“–
Lisa Mega Watts
Lisa Mega Watts

šŸ“–
r2
r2

šŸ“–
IRANKUNDA Fabrice
IRANKUNDA Fabrice

šŸ’»
Kien Nguyen
Kien Nguyen

šŸ’»
Ben Moore
Ben Moore

šŸ’»
Q
Q

šŸ’»
thomageanderson
thomageanderson

šŸ’»
Pietro
Pietro

šŸ’»
codingsh
codingsh

šŸ’»
Ben Botwin
Ben Botwin

šŸ’» šŸ“¦
K. S. Ernest (iFire) Lee
K. S. Ernest (iFire) Lee

šŸ’»
coffeeorgreentea
coffeeorgreentea

šŸ’» šŸš‡ šŸ’¼
Knar
Knar

šŸ’»
Emmy NSABIMANA
Emmy NSABIMANA

šŸ’»

Based on Thoth by Latitude Games

The original source code was made by the following contributors to Thoth, which is archived here

Jakob
Jakob

šŸ’»
Sean Gillespie
Sean Gillespie

šŸ’»
Michael
Michael

šŸ’»
Preston Gull
Preston Gull

šŸ’»šŸŽØ
Nick Walton
Nick Walton

šŸ’»
Mitchell Gordon
Mitchell Gordon

šŸ’»
?/janus
?/janus

šŸ’»
Alan Walton
Alan Walton

šŸ’»

Come Build With Us!

We are building Magick as a community in the open on Discord. If you are interested in contributing to the project, we'd love to have you.

Join us here: https://bit.ly/magickdiscordgh