Zylo-docs seamlessly integrates with FastAPI to automatically generate OpenAPI-compliant specs—so you can write your API docs faster and go home early.
Project description
Build the world’s best API docs highly integrated with FastAPI for developers
Writing technical documentation like API specs is often a burden for software engineers — it’s not their expertise, and rarely a top priority. That’s where Zylo-docs comes in. Zylo-docs seamlessly integrates with FastAPI and automatically generates OpenAPI-compliant specs. With powerful AI assistance, it helps developers create clear, user-friendly, and rich documentation with minimal effort. Think of it as a more intuitive, AI-powered alternative to Swagger.
[1/10] Get Started (Add boilerplate code)
from fastapi import FastAPI
# 👇 [1/2] Add this import at the top
from zylo_docs import zylo_docs
app = FastAPI()
# 👇 [2/2] Add this your entry point file (e.g., main.py)
zylo_docs(app)
@app.get("/")
async def read_root():
return {"message": "Hello, FastAPI!"}
...
...
...
[2/10] Run the FastAPI Server
uvicorn main:app --reload
You need to start the server using Uvicorn.
⚡️ If your server is already running, you can skip this step.
Once the server is running, open your browser and go to: 👉 http://localhost:8000/zylo-docs
(⚠️ If your development server runs on a different port, update the URL accordingly!)
[3/10] Tada! You can now view beautifully structured API specs with zylo-docs.
[4/10] To use Zylo AI, sign up and sign in to zylo.
[5/10] Provide context to the zylo-docs AI
Context example
Our pet store is called "Patricia", and the pet_id represents the registered number of the pet. This should be reflected in the API specs.
Describe how you would like zylo-docs to enrich the document.
[6/10] Use the Zylo AI function to upgrade your docs
[7/10] Tada! Look at the red dot in the top-left corner! It is completed. Let's check this out!
After you find the red dot on the version selector, it means that our API specs are now upgraded and more user-friendly with zylo-docs. you can find the lastest one. Once you click it, you can check the new one filled with rich content.
[8/10] Compare the generated docs with the previous version
[9/10] Regenerate specific parts, such as test cases
[10/10] Share your API docs with your team
Click the Publish button to share your API documentation via email.
- Note : Use authentication to test the token.
- Use x-api by entering the key name and key value
- Use HTTP Bearer by entering the Bearer token value.
Development
- Python 3.10+
- FastAPI, Uvicorn
License
MIT License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file zylib_test-1.2.16.tar.gz.
File metadata
- Download URL: zylib_test-1.2.16.tar.gz
- Upload date:
- Size: 293.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
89fdd8015c209b1c3f13741bdc65b8b09e968dbbadcb44db03959c1321a1cc59
|
|
| MD5 |
2cca5017045af376ffc5fde86899a79b
|
|
| BLAKE2b-256 |
3cce9f83e0b374115238a7f7df0c59cf810f69216c49bdac732b4e659cbcc5f7
|
File details
Details for the file zylib_test-1.2.16-py3-none-any.whl.
File metadata
- Download URL: zylib_test-1.2.16-py3-none-any.whl
- Upload date:
- Size: 298.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
20edf9796df53121f7ad69ac0da513eae3259ea54a5abced93720106bb97d405
|
|
| MD5 |
45729631a3e8b9e761453c8f7008a7f1
|
|
| BLAKE2b-256 |
32f965b1f86d2e0c04032ef7c3ed70c526c033f11284044d7b2f28dbf08b1081
|