Skip to content
Jac Docs

FAQ

Common questions and answers. If you don’t see your question below and couldn’t find a solution in the docs, ask your question in our Discord Community (We try to answer within 2hrs.)

Getting Started & Setup

Section titled “Getting Started & Setup”
I updated to the latest Jaseci PyPI packages and my project won't jac start properly.

Run jac purge to clear the global bytecode cache. This is the recommended approach after upgrading packages:

jac purge

This command works even when the cache is corrupted. If jac purge is not available (older versions), manually clear the cache:

Linux:   rm -rf ~/.cache/jac/bytecode/
macOS:   rm -rf ~/Library/Caches/jac/bytecode/
Windows: rmdir /s /q %LOCALAPPDATA%\jac\cache\bytecode
What do I need to install to get started with Jac?

See the Installation Guide.

What are good first projects to build with Jac?

Check out the To-Do App Tutorial.

Language & Concepts

Section titled “Language & Concepts”
What's the difference between Jac, Jaclang, and Jaseci?
  • Jac: The language
  • Jaclang: The compiler/runtime
  • Jaseci: The full framework and ecosystem including plugins (byllm, jac-client, jac-scale, etc.)
Do I need to know graph theory to use Jaseci?

No. Learn OSP: OSP Guide.

Can I use Python libraries (PyPI) in Jac?

Yes. Jac integrates seamlessly with Python libraries.

What's the learning curve coming from Python? How is Jac different from just using Python?

Jac supersets Python. It adds graph-based architecture and AI-native features. Learn Jac Basics - from Python.

Can ____ be done in Jac? Is ____ compatible with Jac?

Yes, if the answer to any of these questions is yes:

  • Can it be done in Python with any PyPI package?
  • Can it be done in TypeScript/JavaScript with any Node.js package?
  • Can it be done in C with any C-compatible library?

Jac compiles to Python (server), JavaScript (client), and native binaries (C ABI), so any library or tool compatible with those ecosystems is compatible with Jac.

If you find something that works in Python/Node.js/C but doesn’t work in Jac, that’s a bug! Please file an issue or let us know in the Discord.

AI & LLM Integration

Section titled “AI & LLM Integration”
How does byLLM differ from calling OpenAI/Anthropic directly?
  • Standardized interface across AI providers
  • Integrated model management in Jac
  • Simplified prompt engineering

See API key setup.

How do I structure by llm() functions so that the output is deterministic and parseable?

Use structured prompts and response templates. AI Integration Reference.

Production & Deployment

Section titled “Production & Deployment”
How do I deploy a Jac app to production?
Do I need Docker/Kubernetes knowledge to use jac-scale?

No. jac-scale handles containerization and orchestration automatically.

What does jac-scale do automatically?
  • Containerizes Jac application
  • Sets up Kubernetes deployment
  • Manages scaling and load balancing

Kubernetes Deployment Reference.

Debugging & Support

Section titled “Debugging & Support”
Where's the best place to get help?

Join the Jaseci Discord Community and use the #get-help channel.

What debugging tools are available for Jac?
How do I debug graph state visually and trace execution flow?

Use the graph visualization tool in the debugger: Debugging Guide.

How do I test Jac walkers and nodes?

Testing Guide.

Project Structure & Best Practices

Section titled “Project Structure & Best Practices”
Can I build a complete app in one .jac file?

Technically yes, but not recommended. Use modular structure for scalability. See Project Setup.

Can I use Jac with React/frontend frameworks?

Yes. Jac supports React-style components.

How do I structure multi-agent AI systems in Jac?

Use the project template: jac create <project_name> --use <template_name>

Organize files by purpose:

  • .jac: Core logic
  • .cl.jac: Client-side code
  • .impl.jac: Implementation details

See CLI Reference.

How do I handle authentication and authorization in Jac walkers?

See Authentication.

Community & Contributing

Section titled “Community & Contributing”
How active is the Jaseci community?

Very active! Join the Jaseci Discord Community for support and discussions with fellow contributors.

How often is Jac updated?

Check the Release Notes for the latest updates and versions.

How do I contribute to Jaseci?