Eve library
Known Limitations
Guide
Revision 1
On this page
This document provides an honest assessment of current limitations, known
issues, and areas under active development. We believe in transparency about
what works well and what needs improvement.
Table of Contents#
Current State#
Yemaya is under active development . While many features are implemented and
functional, the platform should be considered:
Alpha/Beta quality for production use
Suitable for evaluation , prototyping, and development
Not yet recommended for mission-critical production workloads without
thorough testing
What Works Well#
Core API infrastructure and authentication
Database layer (PostgreSQL, Redis, MinIO)
AI text generation with multiple providers
3D model generation pipeline
GPU job dispatch system
Real-time collaboration foundation
What Needs Work#
End-to-end testing coverage
Production deployment hardening
Documentation completeness
Performance optimization at scale
Some provider integrations
AI Generation Limitations#
Text Generation#
Limitation
Details
Workaround
Token limits
Max ~100K tokens per request (provider-dependent)
Chunk large documents
Rate limits
Provider-imposed limits on requests/minute
Use caching, queue requests
Cost
Can be expensive at scale
Enable cost optimization, use cheaper models for drafts
Hallucination
LLMs may generate incorrect information
Implement verification workflows
Consistency
Results vary between requests
Use temperature=0, provide examples
Image Generation#
Limitation
Details
Workaround
Resolution
Max 1024x1024 (DALL-E 3), varies by provider
Upscale post-generation
Style consistency
Hard to maintain across multiple images
Use consistent prompts, style references
Text in images
Often renders incorrectly
Generate text separately, composite
Specific details
May miss exact requirements
Iterative refinement
Audio Generation#
Limitation
Details
Workaround
Length
Music generation limited to ~30s segments
Concatenate segments
Voice quality
Cloned voices may sound artificial
Use premium voices, fine-tuning
Real-time
Not suitable for real-time streaming
Pre-generate, cache results
3D Generation Limitations#
Model Quality#
Limitation
Details
Workaround
Polygon count
Generated models often have suboptimal topology
Use mesh optimization post-processing
UV mapping
May require manual cleanup
Auto-UV unwrapping, manual touch-up
Texture quality
Can be low resolution or inconsistent
Texture upscaling, manual texturing
Animation-ready
Not automatically rigged for animation
Use auto-rigging feature, manual rigging
Generation Time#
Provider
Typical Time
Notes
Hunyuan
2-5 minutes
Good quality, slower
Meshy
30s-2 minutes
Faster, variable quality
Tripo
1-3 minutes
Good balance
Local
Varies
Depends on hardware
Fully supported : GLB, GLTF, OBJ, FBX
Partially supported : USD, USDZ (export only)
Not supported : Proprietary formats (Maya MB, 3DS Max)
Known Issues#
Complex scenes : Multi-object generation is inconsistent
Specific objects : Some object types (vehicles, architecture) have lower
quality
Scale : Generated models may have incorrect real-world scale
Materials : PBR material generation is basic
Engine Integration Limitations#
Blender Integration#
Limitation
Details
Status
Version support
Only Blender 4.0+ supported
By design
WebSocket connection
Requires Blender addon installed
Manual setup required
Real-time sync
Some operations have latency
Optimization ongoing
Crash recovery
Limited state recovery
Implementing checkpoints
Godot Integration#
Limitation
Details
Status
Version support
Only Godot 4.2+ supported
By design
GDExtension
Requires native compilation
CMake build system
Hot reload
Limited hot reload support
Workaround: restart editor
Unreal Integration#
Limitation
Details
Status
Version support
Only UE 5.3+ supported
By design
Blueprint generation
Basic blueprint support
Advanced features pending
Live link
Requires plugin installation
Documentation available
Linux
Limited support
Windows/Mac prioritized
Unity Integration#
Limitation
Details
Status
Version support
Unity 2022.3+ recommended
LTS versions supported
Package manager
Manual package installation
UPM support planned
Gaussian splatting
Experimental feature
Active development
Metric
Current
Target
Notes
Request latency (p50)
~50ms
<30ms
Excluding AI operations
Request latency (p99)
~200ms
<100ms
Optimization ongoing
Throughput
~1000 req/s
~5000 req/s
Single instance
WebSocket connections
~10,000
~50,000
Per instance
Operation
Current
Notes
Simple queries
<10ms
Well-optimized
Complex joins
50-200ms
May need optimization
Bulk operations
Variable
Batch size dependent
Full-text search
100-500ms
Consider Elasticsearch
Operation
Current
Notes
Small file upload (<1MB)
<1s
Good
Large file upload (>100MB)
10-60s
Multipart upload
Thumbnail generation
1-5s
Async processing
Video transcoding
Minutes
GPU acceleration available
Scalability Considerations#
Current Scale Tested#
Users : Up to 1,000 concurrent users
Requests : Up to 10,000 requests/minute
Data : Up to 1TB storage tested
GPU Jobs : Up to 100 concurrent jobs
Scaling Bottlenecks#
Database connections : Connection pooling required at scale
Redis memory : May need Redis Cluster for large caches
Storage I/O : CDN recommended for asset delivery
GPU providers : Rate limits vary by provider
Not Yet Tested#
Multi-region deployment
10,000+ concurrent users
100+ concurrent GPU jobs
Petabyte-scale storage
Security Considerations#
Implemented#
JWT-based authentication with refresh tokens
Role-based access control (RBAC)
Rate limiting and DDoS protection
Input validation (Zod schemas)
SQL injection prevention (Prisma ORM)
CORS configuration
Helmet security headers
Pending/Partial#
Feature
Status
Notes
SOC 2 compliance
Assessment complete
Certification pending
GDPR compliance
Partially implemented
Data export/deletion available
HIPAA compliance
Not implemented
Not currently in scope
Audit logging
Basic implementation
Advanced features pending
Encryption at rest
Provider-dependent
S3/MinIO native encryption
End-to-end encryption
Not implemented
Planned for sensitive data
Known Security Limitations#
API keys : No automatic rotation (manual process)
Session management : Limited concurrent session controls
File uploads : Basic malware scanning only
Third-party dependencies : Regular updates required
API Limitations#
General API Limits#
Limit
Value
Notes
Request body size
10MB
Increase via config
File upload size
100MB
Multipart for larger
Response timeout
30s
Longer for AI operations
Pagination max
100 items
Per page
Batch operations
100 items
Per request
Endpoint-Specific Limits#
Endpoint
Limit
Notes
/ai/generate
10 req/min (free)
Tier-based
/3d/generate
5 req/min
Cost-based throttling
/auth/login
5 attempts
Then 15min lockout
/webhooks
100 registered
Per account
Missing Features#
GraphQL API (REST only)
Batch API for bulk operations (partial)
API versioning (v1 only currently)
Idempotency keys (partial support)
Known Bugs#
Critical (Actively Working On)#
None currently tracked.
High Priority#
WebSocket reconnection : Occasional connection drops under high load
Large file uploads : Progress reporting inaccurate for files >500MB
3D preview : Memory leak in preview renderer after extended use
Medium Priority#
Search : Full-text search performance degrades with large datasets
Collaboration : Cursor position sync can lag in complex documents
Asset versioning : Diff view not working for binary files
Low Priority#
UI : Minor styling inconsistencies in dark mode
Logs : Timestamp formatting inconsistent across services
Export : Some edge cases in CSV export
Roadmap Items#
Near-term (Next 3 months)#
Medium-term (3-6 months)#
Long-term (6-12 months)#
Reporting Issues#
If you encounter issues not listed here:
Check existing issues :
GitHub Issues
Search documentation : Many common issues are documented
Create new issue : Include reproduction steps, environment details
Join Discord : Real-time help from community
Issue Template#
markdown Copy
## Description
Brief description of the issue
## Steps to Reproduce
1. Step one
2. Step two
3. ...
## Expected Behavior
What should happen
## Actual Behavior
What actually happens
## Environment
- OS:
- Node.js version:
- Browser (if applicable):
- Yemaya version:
## Additional Context
Any other relevant information
Getting Help#
Documentation : https://docs.yemaya.io
GitHub Issues : https://github.com/yemaya/yemaya/issues
Discord : https://discord.gg/yemaya
Email : support@yemaya.io
We appreciate your patience as we continue to improve the platform. Your
feedback helps us prioritize what matters most.