Choose a published installer for your system and follow its release instructions.
Check download availabilityGet a supported build.
Use the installer and release notes provided for your system. Follow that build’s installation instructions, then open Akashic using your system’s app launcher.
For source development, use the repository’s installation documentation. A source checkout requires its own runtime and dependencies.
Release installation notesChoose your model connection.
Complete the model setup shown when you first open the app. Use a supported provider’s sign-in flow or enter your API key where the app requests it.
Your provider controls model access, usage limits, and billing. Keep credentials in the app’s setup flow; never paste API keys into a conversation or issue report.
Bring a project into the picture.
Choose the folder you want to work in, or begin with a conversation. Start with a small project and files you are comfortable using with your selected provider.
A workspace gives the assistant a place to work. Review the selected permission mode before asking it to change files or use tools.
Start with one concrete thing.
A useful request includes your goal, the relevant context, and what you want back.
Read these project notes and draft a one-page brief. Include the goal, open questions, and three next steps. Save it as a Markdown file in this workspace.
You can also ask it to explain a document, help refine a draft, or work through a plan. Results depend on your model and enabled tools.
Look at the result together.
Open the resulting file, check the sources and details, and ask for changes. Review any requested permissions before continuing. Save useful work in your project folder so it remains easy to find.
If a task fails, check the provider connection and error details before retrying. The help page covers common starting points.