Frequently Asked Questions#
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
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:
This command works even when the cache is corrupted. If jac purge is not available (older versions), manually clear the cache:
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
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
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
How do I deploy a Jac app to production?
- Local Deployment:
jac startcreates an HTTP API server. - Kubernetes Deployment: Deploy with a single command.
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
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?
- VS Code debugger support: Debugging Guide
- Writing and running tests: Testing Reference
How do I debug graph state visually and trace execution flow?
Use the graph visualization tool in the debugger: Graph Visualization
How do I test Jac walkers and nodes?
Project Structure & Best Practices
Can I build a complete app in one .jac file?
Technically yes, but not recommended. Use modular structure for scalability: - File System Organization - Frontend/Backend Separation
Can I use Jac with React/frontend frameworks?
Yes. Jac supports: - React component style - Import npm packages
How do I structure multi-agent AI systems in Jac?
- Use 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
How do I handle authentication and authorization in Jac walkers?
Use built-in authentication functions: Authentication Functions
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 GitHub Releases for the latest updates and versions.